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PREFACE 



This manual was written for customer systems programmers, DEC Software 

Specialists, and internal maintenance programmers. Readers must be 

■ 
familiar with the DOS User's Manual, DEC-15-MRDA-D. In addition, chap- 
ter 8 requires familiarity with the BOSS Reference Manual, DEC-15-GUDA-D, 



CHAPTER 1 



DOS OPERATION 



The System Manager must use DOSSAV in order to load DOS-15 for the 
first time. The DOS System Generator manual, DEC-15-YWZB-DN12, des- 
cribes DOSSAV operation in its appendix. After successful DOSSAV op- 
eration, the System Manager should load the Bootstrap into the highest 
bank. (This tells DOS how many banks it can use.) The Bootstrap loads 
the System Loader, which in turn loads the Nonresident Monitor. In 
order to ensure a working system, the System Manager should place the 
DOS-15 Checkout Package tape (RF.CHK, DEC-15-CIDA-PA, for RF DECdisk 
systems, or RP.CHK, DEC-15-CTAA-PA, for RPj3f2 Disk Pack systems) into 
the Paper Tape Reader, and type BATCH PRJ . Operating instructions 
for the Checkout Package, and the tape itself, are distributed as part 
of the DOS-15 system. 

Once the system has been checked out, the System Manager should use 
DOSGEN, the DOS System Generator orogram, to tailor the system to 
his needs. As mentioned in the System Generator manual, a complete 
tailoring of the system may also involve use of PATCH, PIP, and 
UPDATE . 



Commands to the Nonresident Monitor allow temporary modification of 
the system, in order to suit the needs of a particular program. The 
Nonresident Monitor modifies the system by changing information in 
the .SCOM Table. The System Loader examines the . SCOM Table, along 
with three disk-resident information blocks, SYSBLK, COMBLK and SGNBLK, 
and carries out all operations necessary to fulfill the operator's 
commands. The System Loader "builds" the Resident Monitor by relocat- 
ing and linking those routines indicated by the .SCOM table as needed 
by the next core load. The Resident Monitor then retains general con- 
trol over the system. 
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CHAPTER 2 
THE RESIDENT MONITOR 

2.1 INTRODUCTION 

The Resident Monitor gets its name because it seems resident to the user. 
Strictly speaking, however, the only part of the system that is always 
resident is the Bootstrap. There are two parts of the system that are 
refreshed only after manual Bootstrap loads and restarts: . SCOM and the 
Resident Monitor Patch Area. Every time an operator or program changes 
certain key system parameters, the system will build a new Resident 
Monitor from blocks stored on the system device. 

The Resident Monitor is the interface between the operator, and the 
active devices on one hand, and the program which is running (the 
Nonresident Monitor), on the other. The Resident Monitor always contains 
the following routines and tables: 



Chapter 
5 



This 
Chapter 



f .DAT 
( . UFDT 
L.SCOM 

^ The CAL Handler, which routes all System and I/O 

Macro calls 
The Startup routine after using the Bootstrap 
.MED, the Monitor's standard error routine 
The Expanded Error Processor, for more flexibility 

with error messages 
Handlers for the following error conditions: 

Nonexistent Memory 

Memory Protect 

Interrupt-Memory Parity 

Power-Fail 

Software API not set up 
The Monitor's TRAN routine (different from I/O .TRAN's) 
A clock handler 

The .GTBUF and GVBUF processor 
The CTRL Q processor 
The .USER processor 
The .OVRLA processor 
TTA. 
l^ The Resident Monitor's Patch Ai^ea 



In addition, the user can request the system to retain certain other 
routines in a resident Monitor status: 

The CTRL X Feature, including a driver for the VT-15 
The Paper Tape or Card Reader Handler for Batch 
The Resident Batch code 

BOSS-15 also has resident routines, wnich are covered in Chapter 8. 
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2.2 THE CAL HANDLER 

The CAL instruction transfers control to rei^ister 21, bank J?, and loads 
register 2^ with the address of the next instruction after the CAL. 
All DOS I/O and system macros take the form of a CAL instruction (pos- 
sibly with some code in the low-order bits) , and the next sequential 
register contains a dispatch code. Some macros require more informa- 
tion in succeeding registers. Figure 2-1, Resident Monitor CAL Handler, 
illustrates the operation of that portion of the Resident Monitor. The 
CAL Handler does only minimal error checking — for legal function 
code, and for legal .DAT slot. Aside from that, and ensuring the 
clock is turned on, the CAL Handler is only a dispatcher to other 
routines. 

2.3 lOPS ERROR HANDLER, AND THE EXPANDED ERROR PROCESSOR 
2.3.1 .MED 

There are two error processors in the Resident Monitor: .MED and the 
Expanded Error Processor. Figure 2-2 illustrates those routines. 
Figure 2-3 shows two subroutines used by the error routines. .MED 
(location 3, bank J?) processes lOPS errors from all device handlers 
except the disk handlers, and CDB., MTF . , TTA. , and LPA. Calls to 
.MED should take the following form, if not lOPS 4: 

LAC INFO /ARGUMENT OF ERROR 

DAC* (.MED /ADDRESS OF CAL IS ALREADY IN .MED, 

/IF DESIRED 
LAW N /N IS ERROR CODE j?>_N>777. AC MUST BE NEGATIVE. 
JMP* (.MED+1 "" 

lOPS 4 messages may take the following form: 

LAC (4 /AC MUST BE POSITIVE 
JMS* (.MED 

.MED+1 contains a JMP to the Monitor Error Diagnostic Routine. The 
above calls to .MED will cause the following printouts: 

lOPSN (contents of .MED) 
I0PS4 
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ENTER 



i 



Tl Load .MED with tAL address 

2. Turn clock on, if not on 

3. Deposit minus 1 in register 7, 
- or less than minus two 



if 



I0PS2 





lOPS 



The following CAL's 
take this path: 
.EXIT, .OVRLA, .TIMER 
.SETUP, .GTBUF, 
.GVBUF, .GET, & 
.PUT 



Give control to 
proper portion of 
the Resident Mon- 
itor. 



Load AC with 
CAL address 



Modify the 
.UFDT slot 



-M^ 



Device Hand- 
ler carries 
out instruc- 
tion 




Do Monitor TRAN 
(Figure 2-4 ) 



Exit to the 
user 



jl 



Bootstrap 



Resident Monitor CAL Handler 



Figure 2-1 
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A Enter from 
I .SCOM+37 




Put recovery PC in ,MED 



-> 



Print the message 




Resident Monitor 
Initialization 



\ 



Loop 



Zl 



NOTE ; The Nonresident Monitor HALT and 
QDUMP commands will change this loop to 
the appropriate action. BOS and Batch- 
ing Mode abort the $JOB. 



tir± 



Awaxt a character 
from the keyboard 




Resident Monitor 
Initialization 
J ~ 

(Dispatch toN 
appropriate 1 
address >/ 



(Wait f:>r a 
Control Char) 



1. Echo Command 

2. Restore API, if required 

3. Restore PI 



Return 
via .MED 



Expanded Error Processor 
and 
Monitor Error Diagnostic Routine 

.MED 

Figure 2-2 
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SETTLE 



1, Store error number 

2, Set up to turn nulls into 
spaces, if LINK is set 

3, Turn off PI 

4, Wait 110 ms for the teleprinter 
to die down 

5, Type Carriage RETURN, Line Feed 



RETURN 



lOPS 



±. 



Print "lOPS" and error number, 
zero suppressed 




Print a space, foll'owed by the 
octal contents of .MED, followed 
by another space 




Print contents of .SCOM+32 (disk 
block number) 



RETURN 



Resident Monitor Subroutines 



Figure 2-3 
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2.3.2 The Expanded Error Processor 

The disk handlers (except the Bootstrap), CDB. , MTF., TTA. , and LPA. 
use the Expanded Error Processor. Each error message is "potentially" 
recoverable by typing CTRL R. That is, the Resident Monitor always 
returns control to the caller upon a CTRL R. It is up to the caller 
to respond accordingly. All handlers supplied with the system simply 
repeat the error message if the error is unrecoverable. 

The Expanded Error Processor gives the capability of printing addi- 
tional information after the standard lOPS message. As with .MED, the 
AC must contain the error number (j?<^number_<777) in bits 9-17. Control 
must be passed, however, via JMS* (.SCOM+37, not JMP* (.MED+1. 

The following information pertains to the message: LOC+2 must contain 
the two's complement of the number of message words to be typed after 
the standard "lOPSNN nnnnnn" message. If the number is zero or posi- 
tive, no message will be printed. If the LINK is set, nulls will be 
printed as spaces. If the LINK is zero, nulls will be ignored. If 
the AC is positive on calling the expanded error facility, only the 
special message will be printed. The "lOPS" part will be omitted. 
The message itself must be packed in .SIXBT. 



The following are examples of use of the Expanded Error Processor: 



Exsunple a: 



UNREC 



LAC 


STATUS 


DAC* 


C.MED 


STL 




LAW 


ERRNUM 


JMS* 


(.SCOM+37 


JMP 


UNREC 



LAW -1 
.SIXBT 'OKA' 

UNITNO lar 

.SIXBT 'FIL' 
.SIXBT 'E' 
.SIXBT 'SRC 



/STATUS . 

/CAL ADDRESS IS NOW OVERWRITTEN 
/BY CONTENTS OF STATUS REGISTER 
/TURN NULLS INTO SPACES 
y^ERRNUM <Lpfjaf j? 

/THIS IS AN UNRECOVERABLE ERROR* 
/JMP .-1 WILL NOT DO — EXPANDED 
/ERROR PROCESSOR CHANGES THE 
/CONTENTS OF .MED. 



The printout from that code will be as follows: 

IOPS777 nnnnnn DKA FILE SRC 
where nnnnnn is the contents of .MED, and equals the Status Register 
B, and ERRNUM was 777. 
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Example b: 

PARITY LAW 61 

STL /TURNS NULLS INTO SPACES 

JMS* (.SCOM+37 

JMP RETRY /THIS IS A RECOVERABLE ERROR 

LAW -1 

.SIXBT 'DTA' 

The printout from that code will be as follows: 

I0PS61 nnnnnn DTA 

where nnnnnn is the contents of .MED, the address of the last CAL, 
deposited by the CAL Handler. 

2.4 THE SYSTEM BOOTSTRAP 

The System Bootstrap is nothing more than a disk driver. It may load 
the System Loader and Resident Monitor from Hardware Readin, or manual 
restart. All other Bootstrap operations result from the use of the 
Monitor TRAN routine. The Monitor TRAN routine sets up the Bootstrap 
to read or write any block or set of contiguous blocks from the disk 
to or from any location in core. Before calling the Bootstrap, the 
Monitor TRAN does a .WAIT to all .DAT slots in the Mass Storage Busy 
Table, clears all flags, turns off the VT if it was on, and allows the 
clock to tick positive, so that it will keep time but not interrupt. 
After the Bootstrap has finished, it calls the Monitor Initialization 
Routine, which updates the clock and turns on the VT, if necessary. 

The Monitor TRAN Routine requires the following parameter table: 

PARADD L0C+j2f BLKNUM /FIRST BLOCK NUMBER 

LOC+1 FIRSTA-1 /FIRST ADDRESS OF BUFFER, MINUS ONE 

LOC+,2 -SIZE /# OF WORDS TO BE TRANSFERRED IN 2 ' S COM 

LOC+3 START /STARTING ADDRESS AFTER DISK I/O 

/COMPLETION 

The following code illustrates the use of the Monitor TRAN: 

UNIT=lpfjaf(afj2fJ2f /MONITOR TRAN WILL USE UNIT ONE^ 

SC0M=lj2fjaf 



LAC (PARADD /MONITOR TRAN REQUIRES ADDRESS OF 

XOR UNIT /PARAMETER TABLE IN BITS 3-17 AND 

/UNIT NUMBER IN BITS pf-2 OF AC 
STL /NONZERO LINK GIVES TRAN OUT 

JMP* (.SCOM+55 /.SCOM+55 IS USER ENTRY POINT FOR 

/MONITOR TRAN 

See also paragraph 5.7. 



^DECdisk TRANs ignore unit number, use block number. 
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.OVRLA, .EXIT, and manual Q dumps all use the Monitor TRAN routine. 
Figure 2-4, .OVRLA, .EXIT and CTRL Q, illustrates their operation, 
and also the Monitor TRAN. 



For the RF DECdisk, the user can reference a specific platter just by 
identifying the block number he wants. That is, the block numbers to 
not automatically go to zero at the beginning of every platter. The 
block numbers and platter relationships are shown below: 



TABLE 2-1 
RF Platter-Block Number Correspondence 



Platter Number 


Block Number 




1 
2 
3 
4 
5 
6 
7 


0-1777 

2000-3777 

4000-5777 

6000-7777 

10000-11777 

12000-13777 

14000-15777 

16000-17777 


(All numb* 


ars are in octal) 



2.5 system" I/O INITIALIZATION 



There are two routines that do DOS I/O initialization: the startup routine 
after Bootstrap manual loads and restarts, and the startup routine 
performed after Monitor TRAN's and after a CTRL C, P, T or S for an 
error. The startup routine after Bootstrap) loads is described in 
Figure 4-1, The System Loader Interface Routine. Figure 2-5, Resident 
Monitor Initialization, describes the other routine. 



2.6 RESIDENT MONITOR TIMING FEATURES 



Figure 2-6, The Resident Monitor Clock Routine, describes the Resident 
Monitor's time functions. There are three places in DOS which start 
or try to update the clock — (1) the first-time initialization after 
manual Bootstrap loads and restarts, (2) the Resident Monitor Initial- 
ization, and (3) the CAL Handler. The following .SCOM registers con- 
tain timing information: 
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.OVRLA ^\ 
CAL Entry J 



Put System pro- 
gram n«une into 
.SCOM+43,44 (prog 
neune pointed to 
by CAL+2) 



Scan Overlay 
Table (address in 
.SCOM+31) for a 
match with the 
program name 





(^ CTRL Q \ 
I (Manual entry)] 



Echo +Q on 
keyboard 



Put name of the 
Nonresident Mon- 
itor into .SCOM+ 
43 & 44 



Found 



Set up pointer to TRAN 
parameters 




QDUMP Auto 
Entry 



Set LINK (.THAN out) 
and set up pointer to ,TRAN 
parameters for CTRL QAREA 



Set up unit nvmiber and 
pointer to TRAN parame- 
ters for loading .SYSLD 
Clear LINK for .TRAN in 




Update ,SC0M+3; 
clear AC and the 
LINK (Unit 0, & 
.TRAN in) 



Set AC = 777777 



Jik 



Put contents of .SCOM+72 
into ,SC0M+71, and set 
AC with unit nrunber 



(MONITOR 



Store Unit number and 
other TRAN parameters 
in the Bootstrap 



Return to 
user 



TRAN ROUTINE — Independent from 
device handler .TRAN's) 



CLEAR* 
(.WAIT) 



Put starting address into 
location 0, bank 0, and 
set the Bootstrap to go to 
Monitor Recovery Routine 
on exit 



* CLEAR does a .WAIT or a 
.INIT to each entry in 
the Mass Storage Busy 
Table. This precludes 
conflicts between disk 
I/O performed by the 
system disk handler, and 
disk lOT's issued by the 
Bootstrap, an independent 
program. CLEAR also turns 
off the clock and PI, and 
enables BANK mode. 



Bootstrap 



.OVRLA, .EXIT and CTRL Q 
Figure 2-4 
2-9 



Entry \ 

from j 

Bcx3t strap y 



Entry 

from 

RESMON 



Set exit to address in J3 



L 



M. 



Arrive with exit address in AC 



I 



1. 



2. 
3. 
4. 

5. 



Set up clock so that it 
keeps running, but does 
not interrupt (ticks 
positive) 
Clear all flags 
Turn off PI and API 
Restore cell 4 to transfer 
to Error Diagnostic Routine 
Set up proper addressing 
(Bank or Page), according 
to .SCOM+4, bit 7 




1. Update the clock, and allow it to 
interrupt 

2. Clear TTY Busy Switch (Clear all 
flags ensures no I/O to TTY) 

3. Turn API on or off, depending on 
contents of register 6 (The Sys- 
tem Loader loads register 6 ac- 
cording to .SCOM+4, bit 0) 

4. Turn on PI 



Exit to 

Proper 

location 



Resident Monitor Initialization 



Figure 2-5 
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Ent,py from 
PI or API 



Allow clock to tick positive, so it 
will not interrupt for an hour 




Set up the exit from this routine 
to go to the .TIMER address in 
,SC0M+61, is if it were a JMS in- 
struction. Set high-order bits 
of return address with interrupt 
information 



Increment .SCOM4-51 



Increment .SCOM+56 






-^^— ^second 

N 



1. Increment .SCOM+50 

2. Format in hhmmss 

3. Increment .SCOM+34 



Subtract one from register 7, the clock register 




Restore pre- interrupt 
conditions 



3Z 



Exit 



Note: The Clock Routine will use PI if API is busy, or down. 

The Resident Monitor Clock Routine 

Figure 2-6 
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, SCOM+5j2f 
,SC0M+51 
,SCOM+56 
,SC0M+6^ 

SCOM+61 
SCOM+73 
SCOM+74 



Time of day, in hhmmss (six bits each) 
Elapsed time, in ticks 

Time limit, in seconds (zero, if no limit) 
Time left for .TIMER interrupt (zero, if 

.TIMER not in effect) 
Address of .TIMER user interrupt routine 
Number of ticks left in the next second 
Line frequency, in ticks per second 



2.6.1 Clock Operation 



The Nonresident Monitor's TIME command changes or senses .SCOM+5j2(. 
.SCOM+51 is not used by any system program. The clock handler simply 
increments it upon each clock tick. User programs may deposit a known 
quantity into .SCOM+51, in order to time events. The Nonresident 
Monitor deposits the argument for a TIMEST command into .SCOM+56. If 
.SCOM+56 is nonzero, the Resident Monitor will issue an ISZ .SCOM+56 
command each second, until it reaches zero. At such a time, the Resi- 
dent Monitor will perform a .EXIT. MICLOG, LOGIN, and LOGOUT clear 
.SCOM+56. 

2.6.2 .TIMER 



.TIMER allows users to schedule routines for a specified time from 
"now". These routines may return to the interrupted code, if the 
programmer desires. .TIMER users should take care that the time- 
dependent code follows certain rules; 



a. When a programmer does not wish to reset the .TIMER mechan- 
ism, but wishes to return to the interrupted program, his 



code should look like this: 



DAC 



LAC 
RAL 
LAC 
XIT JMP* 



9f 
SAVEAC 



SAVEAC 
C 



/C+1 REACHED VIA JMS 

/MUST NOT USE NON-REENTRANT CODE 

/POSSIBLY USED BY THE INTERRUPTED 

/PROGRAM. (INCLUDES THE CAL IN- 

/STRUCTION) 

/RESTORE THE LINK 

/RESTORE THE AC 
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b. 



When the prograinraer does wish to reset the .TIMER mechanism, 
and return to the interrupted code, his routine should look 
like this: 



.SC0M=1^J? 
CLON=7j2f0j2f44 
CLOF=7j2fj3fp^j2f4 
INTRVL=-li2IJ? 



DAC 



SAVEAC 



/THIS ROUTINE WILL RUN EVERY lj2fj?p+ 
/TICKS ^ 



LAC 

DAC* 

CLOF 



LAC 

DAC* 

LAC 

RAL 

LAC 

CLON 

JMP* 



ADDRES 
(.SCOM+61 



INTRVL 
(.SCOM+6j2f 

C 

SAVEAC 



/RETURN TO THE NEXT ROUTINE 

/TURN THE CLOCK OFF TO ENSURE NO 

/REENTRANCE BEFORE .TIMER RESET AND 

/RETURN 

/DESIRED INTERVAL IN TWO'S COMPLEMENT 

/RESTORE THE LINK 

/RESTORE THE AC 

/TURN THE CLOCK BACK ON (AFTER NEXT 

/INSTRUCTION) 



c. 



When a programmer does not wish to return to the interrupted 
program, he need not save the AC, and he may use the CAL in- 
struction. He should beware of using I/O buffers that may 
still be modified by a handler's interrupt section. In many 
cases, a .INIT to an active .DAT slot will terminate I/O. 
Teleprinter I/O should be terminated by the following: 



XCT* (.SCOM+35 



The user should program a delay of at least llj? milliseconds 
after such an instruction, before he attempts teleprinter I/O 

Note: The interrupt routine will run at the level of the in- 
terrupted code, with the same addressing mode and memory pro- 
tect status. Thus, no debreak and restore is required. 
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2.7 THE RESIDENT MONITOR PATCH AREA 

There are two types of patch area taken from the space allocated at 
assembly time: 

1. That allocated by using PATCH 

2. That allocated when answering the Patch Area 
question in system generation 

Patch area one is the place for permanent changes to the Resident 
Monitor. It is always refreshed when the System Loader comes into 
core. Patch area two is only refreshed on manual Bootstrap loads 
and restarts. The second area would be appropriate for communication 
between successive programs loaded by the System Loader. This area 
should be used because the System Loader refreshes all of core, ex- 
cept the Bootstrap, .SCOM, the CTRL X buffer, and the patch area two. 

The combined size is limited by the current assembly at 47j3jafo. Both 

o 

areas can be initialized, using PATCH. The important dividing line 
between area one and area two is register IjZfl (.SCOM+1) of RESMON. 
The way to allocate more space in part one is to increase the value 
of register lj3l. The way to change the area in part two is to use 
DOSGEN. The second part will start at the address in register lf51. 
The upper bound of the second area will be the sum of the contents 
of register IjZIl, and the number specified to DOSGEN. 

2.8 CONTROL CHARACTERS 

CTRL C, P, R, S, and T are all special characters that interrupt the 
current program and transfer control. The Resident Monitor ignores 
CTRL R except after lOPS 4 and any call to the Expanded Error 
Processor. CTRL S always transfers control to the address in .SCOM+6. 
In the case of core-image system programs and EXECUTE, a CTRL S will 
transfer to register zero, and result in an lOPS 3. The Linking 
Loader places the starting address of the first load module into 
.SCOM+6. 

A .INIT macro to the teleprinter handler will change the address of 
either CTRL C, P or T. The Resident Monitor is always initialized to 
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perform a .EXIT after CTRL C, and ignore CTRL P and T. DDT uses 
CTRL T, and CTRL P is ordinarily used by programs for restarts. 
MACRO-15 expands . INIT to change the CTRL P address. If the programmer 
expands .INIT without the aid of the assembler, a 1J0 in bits zero and 
one of LOC+2 will change the address of CTRL T. A 01 in those bits 
will change the address of CTRL C. It should be obvious that special 
care should be taken with CTRL C. In addition, modifications to the 
CTRL T address should not be made when debugging with DDT. There are 
cases, however, when such modifications are desirable. In particular, 
all zeroes in LOC+2 (2-17) will cause the teleprinter handler to ignore 
CTRL C, P, or T. This address might be used when sensitive code is 
being executed, as in DOSGEN. The following .INIT expansion will 
cause the Resident Monitor to ignore CTRL C: 

CAL-2&777 

1 

2j2rj?j2rjafpr 



2-15 



CHAPTER 3 



THE NONRESIDENT MONITOR 



3 . 1 INTRODUCTION 

The System Loader brings the Nonresident Monitor into core after a 
hardware readin, a manual restart, a CTRL C, or a .EXIT. The ROOM 
Table, SGNBLK, SYSBLK and COMBLK are always coresident with the Non- 
resident Monitor. This gives the Nonresident Monitor access to all 
important system parameters. 

The Nonresident Monitor announces its presence by typing DOS-15 VN.A 
on the teleprinter. It remains in core until the operator requests 
another system program, or until the operator's command implies a 
refreshed configuration of the Resident Monitor is necessary. 

The Nonresident Monitor's actions are limited to (1) decoding commands, 
C2) manipulating or examining bits and registers in .SCOM, .DAT, .UFDT, 
SYSBLK, COMBLK, and SGNBLK, and (3) calling the System Loader, when 
necessary. The Nonresident Monitor has only one entry, which starts 
an initialization section. Figure 3-1, Nonresident Monitor Initial- 
ization, describes that logic. Every time the System Loader brings 
in the Nonresident Monitor, it passes control to the initialization 
section. After initialization, and after all commands that do not 
require the System Loader, the Nonresident Monitor types a $, and 
awaits an input line, terminated by a Carriage RETURN or an ALT MODE. 
It then examines the first six characters (or those up to the first 
blank) and tries to find an entry in the Nonresident Monitor's Command 
Table. If a match is found, control passes to the appropriate routine, 
and thence to the next command, or the System Loader. If the typed 
command does not correspond to an entry in the command table, the 
Nonresident Monitor temporarily assumes the operator wishes a new 
core-image system program, and checks COMBLK for a corresponding entry. 
If there is no corresponding entry in COMBLK, the Nonresident Monitor 
will type an error message, and await the next command. If COMBLK 
contains a matching entry, the Nonresident Monitor composes a .OVRLA, 
and passes control to the System Loader via that .OVRLA. 
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STA.RT 



1. Bank bit initialize pointers to SYSBLK, CX)MBLK and SGNBLK 

2. Determine the number of positive .DAT slots 

3. Save the contents of .DAT-12, in case the user desires LP ON 

(restore before leaving Nonresident Monitor) 

4. Save contents of .SCOM+7 — Nonresident Monitor will use 
.SC»M+7 for address of LPA. or TTA. 

5. Change all .UFDT entries that equal BNK or PAG to SYS 

6. Compute addresses of .DAT-2,+1,+5 and +6 

7. Compute address of beginning of I/O Device Table in SGNBLK 




fi 



Restore ,UFDT eind 
.DAT to SGEN values 



Initialize .DAT-2 and 
.DAT- 3 



<r 




Type out Nonresi- 
dent Monitor's name 




Request a date 



i 



(next page) 
Nonresident Monitor Initialization 

Figure 3-1 
3-2 



(from preceding page) 
^ 



Clear bit 1 of .SCOM+42 
(Nonresident Monitor 
.EXIT flag) 




Load BOSS 



■> 



Read command 
string 



V 



(Continue to Coiranand Decoder) 



Nonresident Monitor Initialization 
(continued) 

Figure 3-1 (Cont. ) 
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3.2 COMMANDS TO THE NONRESIDENT MONITOR 

This paragraph discusses legal commands listed in the Nonresident 
Monitor's Command Table. Table 3-1, Effects and Exits for Nonresident 
Monitor Coiranands , describes all commands that do not request a new 
program. 

There are five entries in the Command Table that load relocatable 
system programs. They are DDT, EXECUTE, GLOAD and LOAD. The Non- 
resident Monitor treats these commands separately, because SYSBLK 
does not list them. All information, necessary for loading these pro- 
grams resides in the Nonresident Monitor itself. 

3.3 CONSIDERATIONS FOR ADDITIONS TO THE NONRESIDENT MONITOR 

Programmers should not attempt to add commands to the Nonresident 
Monitor unless they have access to a copy of the source code. The 
source code may be purchased from Digital Equipment Corporation, 
146 Main Street, Maynard, Massachusetts, under one of the order num- 
bers listed in the footnote. They should then use the EDITOR program 
to put in the indicated changes, and reassemble. 



New additions to the Nonresident Monitor require the following actions 

1. Update the Nonresident Monitor's Command Table. 
The Command Table is in two parts: 

a) The .SIXBT names of the commands 

b) The corresponding transfer vector 

2. Write the code for the command. 

3. Consider the kind of exit the command will take: 

a) Commands that end with a request for a new 
command should end with JMP KLCOM 

b) Commands that re-configure the Nonresident 
Monitor should end with JMP NRMEXl. 



DECtape DEC-15 -SRDA-Ul 
Magtape Unavailable 
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Table 3-1 



Effects and Exits 
for Nonresident Monitor Commands* 



COMMAND 


MODIFIER 


ACTION TAKEN 


EXIT 


API 


ON 
OFF 


Set bit of .SCOM+4. 
Clear bit jZI of .SCOM+4. 


.EXIT 
.EXIT 


ASSIGN 


handler 

(and/or) 
UIC 


Check whether handler is available. 
If yes, load .DAT slot with proper 
handler code. (The proper loader 
will load the handler, and insert 
its starting address into the .DAT 
slot. 

Load proper slot via a .USER 


Next 
Command 

Next 
Command 


BANK 


ON 
OFF 


Set bit 11 of .SCOM+4. 
Clear bit 11 of .SCOM+4. 


Next 
Command 


BATCH 


PR 
CD 


Set bit 1? and clear bit 2 in loca- 
tion 17 77 of the Bootstrap's bank. 
If bit 2 of .SCOM+33 is set (i.e., 
if VT is ON) and bit 17 of .SCOM+33 
is set (i.e., CTRL X is set for VT) , 
set bit 1 of .SCOM+33 in order to 
tell the Resident Monitor Initializa- 
tion to start up CTRL X. 

Set bits pf and 2 of location 1777 of 
the Bootstrap's bank, and set bit 1 
of .SCOM+33 as with BATCH PR. 


.EXIT 
.EXIT 


BUFFS 


number 


Put number indicated into .SCOM+26, 
and set Nonresident Monitor Initial- 
ization to leave .SCOM+26 alone. 


Next 
Command 


CHANNEL 


7 
9 


Clear bit 13 of .SCOM+4. 
Set bit 13 of .SCOM+4 


Next 
Command 


DATE 


date 
no date 


Enter date into .SCOM+4 7. 
Print date from .SCOM+4 7. 


Next 
Command 


* This table assumes error-free input. 
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Table 3-1 (cont. ) 



Effects and Exits 
for Nonresident Monitor Commands 



COMMAND 


MODIFIER 


ACTION TAKEN 


EXIT 


GET 
GETP 
GETS 
GETT 




Set Section 3.4. 




HALF 


ON 
OFF 


Set bit J2f of .SCOM+33. 

Clear bits J? and 1 of .SCOM+33. 


.EXIT 
.EXIT 


HALT 




If not in BOSS-15 mode, put a HLT 
instruction (instead of a JMP) into 
the exit from non-IOPS 4 errors to 
.MED. If in BOSS mode, do nothing. 


Next 
Command 


INSTRUCT 


none 
ERRORS 


Print INSALL Table. 
Print INSERR Table. 


Next 
Command 


KEEP 


ON 
OFF 


Set bit 16 of .SCOM+42. 
Clear bit 16 of .SCOM+42. Initial- 
ize to SGEN default values all en- 
tries in .DAT and .UFDT, except 
change SCR default values to current 
UIC. 


Next 
Command 


LOG 




Output five spaces after Carriacre 
RETURNS. After ALT MODE, go to" 
next command. 


Next Com- 
mand (after 
ALT MODE) 


LOGIN 


uic 


Redefine current UIC (.SCOM+41). 
Clear bit of .SCOM+42, reset vari- 
able system parameters to SGEN de- 
fault values zero .SCOM+56. 


.EXIT 


LOGOUT 




Set current UIC to SCR. Set .UFDT 
entries to SGEN default parameters. 
Deposit zero into .SCOM+42 and 5 6. 


.EXIT 


LOGW 




For BOSS-15, print message. In all 
cases, after a Carriage RETURN, out- 
put five spaces. After ALT MODE, 
type four bells tP , and await CTRL P. 
After CTRL P, go to next command. 


Next Com- 
mand (after 
ALT MODE) 
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Table 3-1 (cont.) 



Effects and Exits 
for Nonresident Monitor Commands 



COMMAND 


MODIFIER 


ACTION TAKEN 


EXIT 


LP 


ON 
OFF 


Set bit 3 of .SCOM+42. 
Clear bit 3 of .SCOM+42. 


.EXIT 
.EXIT 


MICLOG 


mic 


Check key with SGNBLK. If correct, 
set bit of .SCOM+4 2, make "SYS" 
the current UIC, and zero .SCOM+56. 
If incorrect, ignore command. 


Next 
Command 


PAGE 


ON 
OFF 


Clear bit 11 of .SCOM+4. 
Set bit 11 of .SCOM+4. 


Next 
Command 


PROTECT 


n 


If n is between j? and 7, inclusive, 
enter it into .SCOM+54. 


Next 
Command 


PUT 




See Section 3.4. 




QDUMP 




Enter MANSAV, the address of the 
manual CTRL Q, into the exit from 
non-IOPS 4 errors to .MED. 


Next 


REQUEST 


none 
USER 
prog 


Print the current assignments for 
.DAT and .UFDT. 

Print the current assignments for 
all positive .DAT and .UFDT slots. 
Print required .DAT and .UFDT slots, 
and the assignments and use for each 


Next 
Command 


.SCOM 




Print the information for the cur- 
rent system. 


Next 
Command 


TIME 


time 
none 


Enter time into .SC0M+5jZ(. 
Print time from .SC0M+5J?. 


Next 
Command 


VT 


ON 
OFF 


Set bit 2 of .SCOM+33. 

Clear bits 1, 2, and 17 of .SCOM+33. 

Execute 7)?3j344. 


.EXIT 


X4K 


ON 
OFF 


Enter 4j0jJJ3rprj2( into .SCOM+2j3f. 
Deposit zero into .SCOM+2j2f. 


Next 
Command 


33TTY 


ON 
OFF 


Clear bit 2 of .SCOM+4. 
Set bit 2 of .SCOM+4. 


.EXIT 
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4. After assembly, the programmer must call PATCH, in 

order to make his relocatable binary program absolute 
Commands to PATCH should be as follows : 

>D0S15 J 

>READR 16j2(77 DOSNRM BINJ 

16j?77 indicates the highest location the new monitor 
can occupy. (SYSBLK begins at 161j2(J2(.) DOSNRM BIN 
happens to be the file name used by program develop- 
ment. The programmer may, of course, substitute his 
own file name. More information may be found in the 
PATCH manual — DEC-15-YWZB-DN5. 



3.4 QFILE 

QFILE is a system program that allows users to (1) store core images 
in named files, and (2) retrieve such core images for examination via 
DUMP (or possibly for a slow, core-swapping capability) . QFILE imple- 
ments the following Resident Monitor system macros and Nonresident 
Monitor commands: 

.GET, GET, GETP, GETS, GETT , .PUT and PUT 

Users can not obtain QFILE by typing its name to the Nonresident 
Monitor. The Resident Monitor will load QFILE as part of its response 
to the commands and macros listed above. 

PUT creates a file that contains the data in the CTRL QAREA; .PUT 
creates a file from the current core image. GET, GETP, GETS, GETT 
and .GET all overlay core with the contents of the QAREA or file. (The 
different commands specify different startup locations.) In addition 
to the above capabilities, the Resident Monitor provides the capability 
of overlaying core with the contents of the CTRL Q area. The follow- 
ing instructions show how to use that routine: 

UNITN0=4jaf !?{?!? j? /UNIT FOUR 

. SC0M=ljafJ3f 

LAC START /STARTING ADDRESS AFTER THE CTRL Q 

/GET 
XOR UNITNO /UNIT NUMBER IN HIGH-ORDER THREE BITS 

JMP* (.SCOM+6 4 /ADDRESS OF CTRL Q GET ROUTINE 
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Figure 3-2, QFILE, and Implementation of GET and PUT Logic, shows 
the information flow associated with QFILE. QFILE uses the follow- 
ing registers: 



SCOM+7,li2r & 11 
SCOM+65 



SCOM+66-71 
DAT- 14 



.SIXBT Filename and Extension 

Command parameters, packed as follows 

Bits iaf-2 Device unit number 
NRM PUT, when set 
PUT logic, when set 



Bit 8 
Bit 9 
Bits 15-17 Function Code 



CTRL Q Area parameters 

File must be on the device assigned 
to this .DAT slot. 



NOTE 

All GET and .GET operations change all 
of core, except registers ^ through 4 
of bank zero. 
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.GET CAL & 
NRM get's 



.PUT CAL 



Store unit niimber and code into 
.SCOM+65 



1. 



Store unit number and 
function code into 
, SCOM+65 

Set bit 9 of .SCOM+65 
to indicate .PUT 



Nonresident 
Monitor PUT 

31 



1. store unit number and 
function code into 
.SCOM+65 

Set bits 8 and 9 of 
.SCOM+65 to indicate 
NRM PUT 




1. Save , SCOM+65 from the file 

2. Transfer core image file to 
CTRL Q area via dump mode 
.read's and Monitor TRAN's. 



Transfer core image from CTRL Q area 
to named file via Monitor TRAN's and 
dump mode .WRITE 's 




Exit to ^ 

Nonresident J 

Monitory' 




Use function code from file's .SCOM+65 



Do Monitor TRAN from 
CTRL Q area to core 



1. Store correct startup address 

2. Do Monitor TRAN from CTRL Q 
area to core 



Exit to 
CAL+3 



Exit to 

proper 

location 



Note: This chart assumes error free input. 



QFILE, and Implementation of GET and PUT Logic 



Figure 3-2 
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CHAPTER 4 
THE SYSTEM LOADER AND THE LINKING LOADER 



The System Loader is the third major part of the DOS-15 Monitor. The 
other two are the Resident and Nonresident parts. The Resident and 
Nonresident Monitors communicate with the System Loader by manipulat- 
ing certain .SCOM registers. When commands to either part imply a 
new configuration is needed, that part sets up the appropriate .SCOM 
registers, and passes control to the System Bootstrap via the Monitor 
TRAN routine. The Bootstrap then loads the System Loader into high 
core, and gives it control. 

The System Loader examines the .SCOM registers, and loads a fresh copy 
of the Resident Monitor, including any features that the user wishes 
to be resident, such as the CTRL X feature. It will also load the 
desired system program and all handlers required by the new configura- 
tion. In addition, it will allocate all required buffers. The Non- 
resident Monitor is treated like any other core-image system program. 

The System Loader never loads user programs. It only loads core-image 
system programs, the Linking Loader and Execute. The latter two load 
user programs . 

The System Loader uses two device handlers to interface with the disk: 
the System Bootstrap, and the System Loader Disk Handler (DKL.). DKL. 
arrives in core along with SYSBLK, COMBLK and SGNBLK, as well as the 
loader itself. The Bootstrap loads core image programs only. The DKL. 
takes care of relocatable programs and any handlers loaded by the 
System Loader. Those include all handlers for core-image system programs, 
the Linking Loader's own handlers, and any needed by the Execute file. 
The Linking Loader loads some handlers needed by user programs it links. 

There are two parts to the System Loader: the System Loader Interface, 
and the System Loader proper (.SYSLD). Figure 4-1 describes the System 
Loader Interface. Figure 4-2 describes the System Loader Proper, and 
Figure 4-3 describes the Linking Loader. 
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T7 

2. 
3. 



4. 
5. 



7. 

a. 



9. 
10. 
11. 



e Bootstrap ^ 
Loads J 



Turn on the clock 
Initialize 
,SCOM+0 First free reg- 
ister below the 
Bootstrap 
.SCOM+4 SGEN default 
,SCOM+20 Bit zero set, if 
extra 4K; rest 
zero 
.SCXDM+33 VT S HALF, as 

per SGEN 
.SCOM+74 Line frequency 
-Move to highest bank 



Normal 
Initializ- 
ation 



Zero .SCOM+36, to indicate no entries in the Mass Storage 

Busy Table 

Move Resident Monitor into lower core 

Set up: Jump to Skip Chain 

CAL* error 

Legal CAL jump 
Turn API on or off, depending on bit of .SCOM+4 (set=on) 
Bank bit initialize Resident Monitor to talk to the 
Bootstrap, and load .SYSLD into the proper bank upon a 
subsequent .EXIT or .OVRLA. 

Initialize the Bootstrap with the proper lOPS 4 address for 
disk not ready 

Calculate the Skip Chain from SGNBLK 

Set all API channel registers to point to lOPS 3 (with the 
exception of the clock interrupt) and all software levels 
to point to lOPS 30 

Put transfer vector to .DAT slots into .SCCM+23 
Put number of positive .DAT slots into .SCOM+24 
Put pointer to .UFDT+0 into .SCOM+25 



.TRAN image of .DAT 
and ,UFDT in from 
block 37 of the sys- 
tem device, unit 




.TRAN image of .DAT 
and .UFDT out to 
block 37 of the sys- 
tem device, unit 



>TI7<^ 



1. Zero .DAT-7 (i.e., not yet set up) 

2. Set up .J5AT-2 and .DAT-3 for TTA. 

3. Update .SCOM+1 and +2 to point 
just above the Skip Chain, .DAT 
and .UFDT 



Next Page 
System Loader Initialization 

Figure 4-1 
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From Preceding Page 




Set up LPA in 
.DAT-12 




Set up TTA, 
in .DAT-12 



> 



-^ 



1. Put number of system device's "A" handler (DKA. or DPA. ) 
into .SCOM+57 

2. Set up tabbing for cvirrent teleprinter 

3. Set .SCOM+2^ to initial state (as in first time initialization) 

4. Set up for CTRL Q — ignore Q-dumps if RF systan and QAREA too 
small, or nonexistent 

5. Set up for lOPS errors upon the followina interrupts: 

Nonexistent Memory (lOPS 31) 
Mennory Protect Violation (IOPS32) 
Memory Parity Error (IOPS33) 
Power Fail Not Set Up (IOPS34) 




Y — Non-BOSS Batch 



Set up for the 
proper input 
device (CD or PR) 




<r 




Set switch to ig- 
nore input until $JOB 



Next Page 
System Loader Initialization 

Figure 4-1 (Cont. ) 
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From Preceding Page 
Jc 



1. 



2. 



3. 



Set up CTRL C to clear the Batch Switch (bit 1 of 17777 

of the Bootstrap) 

Set up CTRL T to abort current job, and start the Batch 

Monitor looking for the next $JOB line 

Relocate proper batch handler (PR or CD) to low core 

4. Put handler entry point into .DAT-2 

5. Set lOPS errors to abort job — effectively a CTRL T 

6. Set up all batch device .DAT slots to refer to the hand- 
ler currently in core. That is, only one batch input 
device is allowed at any one time 

7. Clear $JOB read switch (bit 1 of Bootstrap 17777) 

8. Perform .INIT to .DAT-2 




Clear bits 14, 15 
and 17 of .SC0M442 



1. Relocate Resident BOSS 
and link it to the DOS 
Resident Monitor 

2. Patch DOS Resident Mon- 
itor to accomodate BOSS 

3. Set bits 14, 15 and 17 
of .SCOM+42, to tell 
.SYSLD to set up .DAT-7 
and +6 




Relocate and 
link CTRL X 
code, and give 
proper buffer 




Set up linkages between 
CTRL X code and the 
Resident Monitor 



■>- 



Next Page 
System Loader Initialization 

Figure 4-1 (Cont.) 
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From Preceding Page 



1. 



2. 



3. 




Allocate the number of buffers 
indicated by .SCOM+26 
Set up File Buffers Transfer 
Vector Table pointer, in .SCOM+30 
Store one of the following codes 
into .SCOM+6: 



LOAD 
GLOAD 
DDT 
DDTNS 
Zero .SCOM+5 



100000 
300000 
400000 
500000 



Tell .SYSLD by setting 

SCOM+11 to XCS (avoids 
two handlers in core for 
same device) 



■^ 




Allocate number of 
buffers indicated 
by , SCOM+26 
Set up File Buffers 
Transfer Vector 
Table in .SCOM+30 
Set .SCOM+6 = 

Put 13 into .srOM-l.'^ 



(Loading a Core-Image Program) 
1. Find entry in SYSBLK and COMBLK 
_^ 2. Build Overlay Table from information in COMBLK, and set .SCOM+31 to 
^ first word in the table 

3. Store the number of overlays in the overlay processor of the Resident 
Monitor 




2. 



3. 



Store the list of active .DAT slots de- 
rived from COMBLK in the System Loader 
command area, just below the Bootstrap, 
and delimit the list with a zero 
If the Nonresident Monitor was not the 
last program, restore .SCOM+26 to default 
Allocate space for, and set up .SCOM+30 
to point to the File Buffers Transfer 
Vector Table 



■.%i 



Next ^Page 
System Loader Initialization 

Figure 4-1 (Cent. ) 
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\/. 



Set bit 3 
of .SCOM+4 




From Preceding Page 




■> 



<■ 



1. 
2. 



Zero ,SC0M+6 

Put 1 

into .SCOM+5 



Clear bit 3 
of .SCOM+4 



1. Move the RCOM Table to position below 
the Bootstrap 

2. Build the IOC Table 



^ 



^ Bring in^ 
.SYSLD via 
.Monitor TRAN. 



System Loader Initialization 

Figure 4-1 (Cont. ) 
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Entry 
from init- 
ializatioiL 



:k. 



1. Set up for Page or Bank Mode 

2. Set up .DAT-7 for the System Loader disk handler (DKA. or DPA. ) 

3. Clear free core, and initialize bank bits in pointers to the Bootstrap 

4. Make a Mass Storage Busy Tcible consisting of one entry 




Set up CTRL P 
address 



^ 




±. 



1. Change XCS to XCT 

2. Allow reading of 
EXECUTE file by the 
System Loader Handler 



> 



±. 



I ^ 

Clear memory bank pointers of banks that 
do not exist 




Load handlers into extra 4k, 
if it exists 





Put System Device's code into 
.DAT+18, to allow subsequent 
insertion into .DAT-7 



^P 

Next Page 
The System Loader 

Figure 4-2 
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From Preceding Page 




lOPROS: all 
.DAT slots in 
iyj:able just under^ 
Bootstrap 



lOPROS \ 
.DAT-1, ~5 / 



/ lOPROSX 
\ .DAT~4/ 




1. 



2. 
3. 

4. 



Translate the handler code from radix 

50 to .SIXBT 

Do .USER to .UFDT-7, using "lOS" 

Do .INIT and .SEEK to ,DAT-7, in order 

to get the handler file 

Load handler via .DAT-7, and close .DAT-7 



<■ 



N — not 



Read EXECUTE file 
for desired handlers 



Note: Subroutine lOPROS accepts 
.DAT slots as input. If the in- 
dicated .DAT slot contains zero, ^ 
the slot is unassigned, and lOPROS 

returns. If not zero, lOPROS checks 

whether the desired handler has al- 
ready been loaded. If the handler 
is in core, lOPROS loads the .DAT 
slot with the handler's starting ad- 
dress and returns. If the handler has 
not been loaded, the handler code is made 
an unresolved .GLOBL, to be satisfied 
by the loop that follows immediately. 



lOPROS \ 
.DAT slots from 
EXECUTE file / 




1. 



2. 



Set up Mass Storage Busy 

Table Entries for all 

active .DAT slots 

Set ,SC0M+1 to first free 

location in core — often 

becomes first location of 

EXECUTE 



<■ 



next page 



The System Loader 
Figure 4-2 (Cont. ) 
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From Preceding Page 



Ak 



Load and relocate EXECUTE or the Linking 
Loader, and place starting address into 
.SCOM+5 




1. Set up Mass Storage Busy table with 
one entry per active .DAT slot 

2. Move the IOC table from the System 
Loader's area (just beneath the 
Bootstrap) to the Linking Loader's 
area 



■> 



^ 



Set ,SC0M+2 and +3 to delimit free core 



± 



{ BOSCKl > 



^ 



Exit to ad- 
dress in 
s^ .SCOM+5 




1. Allocate all necessary buffers 

2. If the system has an extra 4K, 
put the first free address beneath 
the handlers into .SCOM+20 

3. Update first free location in core 
shown in .SCOM+2 — .OVRLA updates 
the first free address beneath the 
Bootstrap, .SCOM+3 



\ BOSCKl / 



Ak 



/ Exit via 1 
V .OVRLA ) 

Note: Subroutine BOSCKl does the following, if loading a program under BOSS-ISj 
(1) .USER to .UFDT-7, (2) .SEEK to .DAT-7 for PRCFIL PRC. 



The System Loader 

Figure 4-2 (Cont. ) 
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START 



1. Clear all of core aibove the loader, including the extra 4K, if present, and 
excluding the Bootstrap 

2. Initialize the Load Table with the first free address in every bank or page 

3. Indicate all core below the address in .SCOM+2 as not free 

4. Compute transfer vectors to .DAT-1, -3, -4, -5, and -7, eind a pointer to 
.UFDT-1 

5. Save the contents of , UFDT-1 




DDT 



_^ 



Load DDT and set the 
symbol flag, if not 
DDTNS 



> 



< 



Type appropriate 
name, and await 
ccxnmand string 




1. Check for P, G and C switches 

2. Translate all file names after left arrow into .SIXBT, pad with blanks, 
and store in symbol table 

3. After ALT MODE, load to end-of-file each file on .DAT-4, and put starting 
address of the first file (i.e., not DDT) into ,SC0M+6 




After every end of tape, type +P 
and await CTRL P — continue 
until ntunber of tapes equals the 
number of commas, plus one 



> 



Next Page 
The Linking Loader 
Figure 4-3 
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NOTE: 

During the library searches 
diagrammed on this page, the 
Linking Loader tests for 
more unresolved .GLOBL's af- 
ter each resolution. When- 
ever there are no more unre- 
solved .GLOBL's, the Linking 
Loader halts its library 
searches, and goes directly 
to the COMMON area allocation 
code (next to the last box 
on this page). Thus, the 
libraries are never searched 
more than is necessary. 



< 



From Preceding Page 

U 



Check Symbol Table for handlers 
needed, and load them from .DAT 
-1, using lOS as a UIC; exit if 
illegal .DAT slots are desired 



Replace old UIC 
for .UFDT-1 




Check Symbol Table for any 
unresolved . GLOBL ' s 




2iL 



1. 

2. 



3. 



Do .SEEK to LIBR5 BIN on .DAT-5 
Read through user's library and 
load any program units that sat- 
isfy any .GLOBL's 
Read to end of library file, if 
still unresolved .GLOBL's 



I iK 

If any unresolved .GLOBL's, try to 
find prograun units in the system 
library (.LIBR BIN) on .DAT-1 



^ 



Scan Symbol Table for Common Blocks, 
and allocate space and set pointers, 
as needed. If any unresolved .GLOBL's 
seek matches in the Common Blocks 



Exit to the 
Nonresident 
Monitor 




The Linking Loader 

Figure 4-3 (Cont, 
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Next Page 



From Preceding Page 




Set .SCOM+2 just be 
low the Loader 



Set .SCOM+2 above the 
Loader ' s highest hand- 
ler — no handler is 
overlayed 



■> 



J± 



Set .SCOM+2 below all 
of the Loader's hand- 
lers, and the Loader 
itself 



<- 



Allocate the Mass Storage Busy Table, 
with the number of entries equal the 
sum of the active .DAT slots, minus 
one — i.e., the two .DAT slots for 
the teleprinter are omitted, and one for 
.DAT-7 is added 



GLOAD 



± 



/control goes*" 
to address in 
V .SCOM+6 > 




LOAD 



Put lowest address of 
the Symbol Table into 
.SCOM+11, and the high- 
est into .SCOM+2 — 
DDT will recalculate 
.SCOM+2 



J^ 



Await 
CTRL S 



/Control goeSv 
to address in] 
VsCOM+5 (DDT)y 



The Linking Loader 
Figure 4-3 (Cent.) 
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4.1 MANUAL BOOTSTRAP LOADS AND RESTARTS 

Manual Bootstrap loads and restarts bring blocks |?-36 of the system 
device into the lowest bank. These blocks contains the Resident Moni- 
tor, the System Loader Interface Routine, and SYSBLK, COMBLK and SGNBLK. 
Figure 4-4 illustrates the core load after manual Bootstrap loads and 
restarts. The Interface sets up .SC0Mh-|?, 4, 2^, 21, 33, 54 and 74 
from SGNBLK values determined at system generation time, and then 
transfers the whole core image of the Interface to the Bootstrap's 
bank. (DOS requires 16K, because this bank must be different from 
bank |?.) At all other times, the Bootstrap loads the System Loader 
into its own bank. This preserves the image of .SCOM, part two of 
the Resident Monitor patch area, and the CTRL X buffer. 

4.2 LOADING SYSTEM PROGRAMS 

The System Loader Interface Routine gets control in the highest bank, 
either by a transfer from the lowest bank, or by load from the Boot- 
strap. After setting up for the System Loader Proper (.SYSLD), accord- 
ing to the program to be loaded and the settings of certain SCOM regis- 
ters, the Interface Routine brings it in as a complete overlay. Figure 
4-5 illustrates the core configuration of the Interface when it is 
in the highest bank. (The addresses provided are for a 16K system.) 
The System Loader loads handlers from the lowest part of free core up, 
with the exception that the extra 4K is filled first, if it exists. 
Core image system programs are usually loaded just beneath the Bootstrap 
(always in the highest bank) . Such core images must be wholely within 
the top bank of core, and above register 17 of that bank. Figure 4-6 
illustrates the core maps for system programs. 



Whenever the Linking Loader is loaded (LOAD, GLOAD, DDT, and DDTNS) , 
the System Loader loads all handlers for .DAT slots -1, -4, and -5, 
and then loads the Linking Loader itself. (DDT is loaded by the 
Linking Loader.) Figure 4-7 illustrates the core maps for the Linking 
Loader. 

For EXECUTE, the System Loader loads EXECUTE'S handler, and reads the 
EXECUTE file, in order to determine the active .DAT slots. The System 
Loader then loads all the handlers required, and sets up the .DAT 
slots. Figure 4-8 illustrates core maps for EXECUTE. 
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16K, 24K, 32K 



BOOTSTRAP 



RCOM TABLE 



SYS3LK andCOMBLK 



16K, 24K,32K 



37500 I16K) 
37100 (16KI 



3 SYSTEM BLOCKS 



SYSTEM LOADER INTERFACE 
loverlayed by SYSLD) 



SYSTEM LOADER INTERFACE 



RESIDENT MONITOR IMAGE 



RESIDENT MONITOR 



Figure 4-4 
Bootstrap Load 



BOOTSTRAP 



SYSTEM PROGRAM 
<THIS AREA IS USED BY CORE 
IMAGES. SOME ROOM UNDERNEATH 
THE BOOTSTRAP MAY BE LEFT 
FREE FOR COMMUNICATION 
BETWEEN CORE IMAGES IN AN 
OVERLAY STRUCTURE. 
CORE IMAGES MUST BE SK OR 
LESS.I 



HANDLERS, BUFFERS 



BUFFER POOL 
TRANSFER VECTORS 



OVERLAY TABLE 



DEVICE TABLE 



RESIDENT MONITOR 



Figure 4-6 

System 
Program Load 



16K, 24K, 32K 



BOOTSTRAP 



DDT, IF PRESENT 



LOADED PROGRAMS 

ON DDT LOADS, SYMBOLS 
ARE MOVED INTO THE 
LOWEST PART OF FREE CORE. 

SYMBOL TABLE 

SYMBOLS AND PROGRAMS BUILD 
TOWARD EACH OTHER. 



LINKING LOADER' 



LOADER HANDLERS 



BUFFER POOL 



BUFFER POOL 
TRANSFER VECTORS 



RESIDENT MONITOR 



16K, 24K, 32K 



.SCOM .SCOM+3 



•Placement of .SCOM+2 depends on relative 
positions of the Linking Loader and its handlers 



Figure 4-7 
Linking Loader 



RESIDENT MONITOR 



i.SC0M*1 and +2. 



Figure 4-5 

Standard 
Interface Load 



BOOTSTRAP 



OVERLAY SYSTEM 
BLANK COMMON 



ALL HANDLERS REQUIRED 



BUFFER POOL 



RESIDENT MONITOR 



Figure 4-1 
Execute 



16K, 24K, 32K 
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BOSS-15 Mode operation requires the system "A" handler be assigned to 
.DAT-7. This requires a sleight of hand on the part of the System 
Loader, which needs the "L" handler on .DAT-7. It therefore loads 
the "A" handler as if it were assigned to .DAT+pr, and transfers the 
set up .DAT slot I? contents to .DAT-7 before transferring control to 
the program being loaded. .DAT+J? is then restored to its original 
status . 

4.4 TABLES AND INFORMATION BLOCKS USED AND BUILT BY LOADERS 

The System Loader uses SYSBLK, COMBLK, SGNBLK, block 37 of the system 
device, .SCOM, the RCOM Table, the IOC Table, the Device Table, the 
Mass Storage Busy Table, the File Buffers Transfer Vector Table, the 
Overlay Table, .DAT, .UFDT and three bits in the Bootstrap. Tables 
4-1, 4-II and 4-III describe how the Loaders use these blocks and tables. 



4.5 .DAT SLOT MANIPULATION BY THE SYSTEM LOADER 

The System Loader maintains the .DAT slot device handler assignments 
as they were the last time the Nonresident Monitor was in core. The 
Loader saves the .DAT and .UFDT on the system device whenever the 
Nonresident Monitor was the last program in core. Thereafter, the 
Loader refreshes .DAT and .UFDT from the image on the disk. If KEEP 
is off, the Nonresident Monitor's initialization routine restores the 
.DAT and .UFDT to default values. 



When loading core-image system programs, the System Loader determines 
the active .DAT slots by examining COMBLK. When loading EXECUT, the 
System Loader sets up .DAT-4, and any active slots indicated by the 
Execute file itself. When loading the Linking Loader, the System 
Loader sets up .DAT-1, -4, and -5. The Linking Loader will set up other 
other active .DAT slots according to the . lODEV commands in the as- 
sembly of the program units being loaded. 



Both the System Loader and the Linking Loader set up .DAT slots in 
this manner: (In the following procedure, "loader" refers to either 
one. ) 
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Table 4-1 



Tables and Block^ 
Used by the Loaders 



NAME 


USE 


LOCATION 


SYSBLK 


The System Loader obtains Monitor TRAN 
parameters from SYSBLK when it builds 


165jafj? of 

. SYSLD 's bank 


COMBLK 


Indicates number of buffers required, 
the active .DAT slots, and the names 


171j2fjy down, in 
. SYSLD 's bank 


SGNBLK 


Default settings for .SCOM registers, 
number of words per buffer, size of 
Resident Monitor's patch area (part 
two). Skip Chain, .DAT and .UFDT de- 
fault contents, and handler informa- 
tion. 


161j2fpf of 

. SYSLD 's bank 


Block 37 
of the Sys- 
tem Device 


Image of .DAT and .UFDT, when last pro- 
gram was loaded (excluding the Nonresi- 
dent Monitor) . 




.SCOM Table 


See Table 4-II. 


10^ of 1st bank 


RCOM Table 


Moved for use by the Nonresident Monitor. 


175J3rj? of the 
highest bank 


IOC Table 


Built by Interface Routine for . SYSLD 
itself. 


Just beneath 
the System 
Loader 


Device 
Table 


Built by Interface Routine if loading 
PIP, or if PIP is among the overlays 
listed in COMBLK 


Just above 
.SCOM+1 


Mass Storage 
Busy Table 


Built by the System Loader itself. 


Pointed to by 
.SCOM+62 


File Buffers 
Transfer Vec- 
tor Table 


Allocated by the Interface Routine, and 
initialized by it for non-core Image 
programs. System Loader proper initial- 
izes for core-image programs. 


Pointed to by 
. SCOM+30 


Overlay 
Table 


Built by the Interface Routine 


Pointed to by 
.SCOM+31 


• DAT 

and 

.UFDT 


Image stored and restored from block 37 
of the System Device. The System Loader 
loads all handlers for core-image pro- 
grams and EXECUTE Files, and sets up 
the appropriate .DAT slots. The System 
Loader also loads handlers assigned to 
.DAT-1, -4, and -5 when loading the 
Linking Loader, and .DAT- 7 and +6 for 
BOSS-15. 


Pointed to by 
.SCOM+23 and 
.SCOM+25 


BOOTSTRAP 


Bits J2f, 1, and 2 of location 17777 in 
the Bootstrap's bank used for Batch (non- 
BOSS) information. 
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Table 4-II 



SCOM REGISTERS USED BY THE SYSTEM LOADER 



.SCOM+ 


Description of Use by the System Loader 


9 


Set in first-time initialization routine. Used to locate 
the System Loader Command Area, which is just below the 
Bootstrap. 


1 


System Loader Interface routine updates this indication 
of the first free register above the Resident Monitor 
each time it moves a piece down to low core. 


2 


The Interface and .SYSLD itself continually update this 
indication of the first free location as they move code 
and build tables. 


3 


Updated as with .SCOM+2. Last free location in core. 


4 


First Time Initialization routine sets this register ac- 
cording to a SGNBLK parameter. 
Refer to Table 4-III. 


5 


Interface Routine stores code of program to be loaded 
into .SCOM+5. .SYSLD uses .SCOM+5 for starting address 
when loading EXECUT or LOAD. The .OVRLA routine loads 
.SCOM+5 with starting address of the Monitor Recovery 
Routine. The Bootstrap transfers to the address in 
.SCOM+5 after all its operations. 


6 


Interface Routine stores codes for DDT, DDTNS , LOAD and 
GLOAD into .SCOM+6. For other programs, the Interface 
Routine zeroes .SCOM+6. 


7 


.SYSLD saves contents of .DAT-1 in .SCOM+7, when loading 
the Linking Loader. When loading EXECUT, .SCOM+7 con- 
tains the first three characters of the Execute file's 
name. Contains .DAT-1 2 when loading Nonresident Monitor. 


ipf 


• SYSLD saves contents of .DAT-4 in SC0M+1J3, when loading 
the Linking Loader. When loading EXECUT, .SCOM+10 con- 
tains the second three characters of the Execute file's 
name . 


11 


•SYSLD saves contents of .DAT-5 in .SCOM+11, when loading 
the Linking Loader. When loading EXECUT, .SCOM+11 con- 
tains the extension of the Execute file's name. (The 
Interface routine sets .SCOM+11 to XCS , telling .SYSLD 
that EXECUT will be using the system device. .SYSLD 
then restores .SCOM+11 to XCT. ) 


12- 

15 


The Interface routine initializes these transfer vectors 
for API software levels to point to SERR, an error routine 
that will produce an IOPS3j2f. 


16, 
17 


Unaffected. 







4-17 



Table 4-II CCont'd) 



. SCOM+ 


Description of Use by the System Loader 


2j3r 


Bit zero set in first time initialization, if system con- 
tains an extra 4K. If the system does contain an extra 
4K, the System Loader will load handlers in that page — 
from the bottom up — when loading a core-image program. 
Whenever there is an extra 4K, the System Loader will 
update bits 3-17 with the address of the first free cell 
in the extra 4K. 


21 


Unaffected. 


22 


Unaffected. 


23 


The Interface Routine refreshes this pointer to .DAT. 


24 


The Interface Routine refreshes this indication of the 
number of positive .DAT slots. 


25 


The Interface Routine refreshes this pointer to .UFDT+0. 


26 


When the Nonresident Monitor was the last program, the 
System Loader allocates the number of buffers indicated 
by the contents of .SCOM+26. If the Nonresident Monitor 
was not the last program, the System Loader restores 
.SCOM+26 to the default value if program to be loaded is 
core image. Otherwise, untouched. 


27 


The first time initialization routine sets this indica- 
tion of the number of words per file buffer. 


3^ 


The Initialization Routine loads this pointer to the 
File Buffer Transfer Vector Table. 


31 


When loading a core-image program, the Interface Routine 
loads .SCOM+31 with the pointer to the Overlay Table, or 
with zero, if there is none. 


32 


Unaffected. 


33 


See Interface Routine table, to determine how that routine 
reacts to the bits in .SCOM+33. 


34, 35 


Unaffected. 


36 


System Loader loads with the number of active .DAT slots 
assigned to the system device. 


37-42 


Unaffected. 


43, 44 


Contains name of the program to be loaded. 


45-56 


Unaffected. 


57 


System Loader loads with the number of entries in the 
Mass Storage Busy Table. 


691, 61 


Unaffected. 


62 


System Loader loads with the address of the first entry 
in the Mass Storage Busy Table. 


6 3- 


Unaffected. 
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Table 4-III 



Use of .SCOM+4 by the System Loader 



Bit 





If set, place "API ON" constant into 0^i?j2fi?6 - 

If clear, place "API OFF" constant in same register. 


1 


Ignored. 


2 


If set, change the Resident Monitor so it will tab 
with the KSR 35/37 tabbing mechanism. 


3 


Loader will set this bit, if loading the Nonresident 
Monitor; clear it otherwise. 


4-6 


Ignored. 


7 


Loader sets this bit if bit 11 is cleared, and load- 
ing the Linking Loader or Execute. Otherwise clear. 


8 


Sets or clears, after comparing current core size 
(known by location of Bootstrap, and status of bit j?, 
.SCOM+2j2f) with SGNBLK parameter. Also, modifies 
Resident Monitor to give IOPS77 after attempts to use 
CTRL Q. 


9, 10 


Ignored 


11 


Indicates whether to clear or set bit 7, when loading 
Linking Loader or Execute. 


12-17 


Ignored 
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1. Each .DAT slot will contain a handler number — either the 
system default, or one inserted via an ASSIGN command to 
the Nonresident Monitor. This handler number is the rela- 
tive location of the handler name in the IOC Table, which 
the Interface Routine builds. (The IOC Table contains 
handler names in Radix 5^.) 

2. For each active .DAT slot, the loader uses the handler 
number in that slot to find the name in the IOC table, and 
converts the name to .SIXBT. 

3. If the handler is already in core, the loader simply inserts 
the starting address of the handler into the .DAT slot. 

4. If the handler is not yet in core, the loader does a .SEEK 
to lOS for the handler, reads it into core, relocates it, 
and places the starting address of the handler into the 
.DAT slot. 



The System Loader always sets up .DAT-2 and -3. (It reserves .DAT-7 
for its own use.) When not in non-BOSS Batch Mode, -2 is assigned 
to TTA. In non-BOSS Batch Mode, the batch input device goes to -2. 
If loading the Nonresident Monitor and bit three of .SCOM+42 is set, 

the System Loader will set up .DAT-12 for the LPA, if it is in the 
system, or else for TTA. If in BOSS mode, the Nonresident Monitor 
assigns LPA. to .DAT+6, and the System Loader assigns .DAT-7 to the 
system device "A" handler. The System Loader then ensures that both 
handlers are in core. The Resident BOSS set up routine subsequently 
routes all .DAT slots connected to TTA. to Resident BOSS. 



4.6 BUFFER ALLOCATION BY THE SYSTEM LOADEJR 

The System Loader allocates space for buffers equal to the contents 
of .SCOM+26 times the contents of .SCOM+27. The first time initial- 
ization routine sets .SCOM+27 to the standard number of locations per 
buffer. Before the Nonresident Monitor does an .OVRLA to a software 
system program, it checks whether a BUFFS command has been issued. 
If so, it leaves .SCOM+26 as is. If not, it uses the default number 
of buffers for that program, as shown in SYSBLK. 
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CHAPTER 5 



SYSTEM INFORMATION BLOCKS AND TABLES 



5.1 CORE-RESIDENT NON-REFRESHED REGISTERS 

The .SCOM table, the Bootstrap and the resident Patch Area are the 
only registers not refreshed by the System Loader. Table 5-1 de- 
scribes the .SCOM Table. 

5.2 DISK- RESIDENT UNCHANGING BLOCKS: SYSBLK, COMBLK AND SGNBLK 

SYSBLK, COMBLK and SGNBLK occupy blocks 34, 35, and 36 (octal) on the 
system device (unit zero) . SYSBLK and COMBLK (blocks 34 and 35) contain 
the parameters for loading all core image system programs. SGNBLK con- 
tains all the other information needed to run DOS. All three arrive 

in core along with the Resident Monitor and the System Loader Inter- 

I 
face, and start at location 161j2fj2( of the highest bank. The Nonresident 

I 
Monitor and System Loader use them, and DOSGEN and PATCH modify them, 

when necessary. 

I 

5.2.1 SYSBLK 

SYSBLK contains the parameters required for implementation of .OVRLA 
to any system program, or any of the system program overlays. 

The order of entries in SYSBLK is unimportant, except for the first 
three permanent entries: RESMON, .SYSLD, and fOAREA. The first word 
of SYSBLK contains the block address (the unrelocated address) of the 
first free word after itself. Figure 5-1 describes SYSBLK. 

5.2.2 COMBLK 

COMBLK contains information the System Loader and the Nonresident 
Monitor need to remember about the current core-image system programs. 
The last location in COMBLK (that is, location 377 of block 35) con- 
tains the block address of the first entry in COMBLK. The remainder 
of COMBLK consists of variable-length entries associated with the 
system programs. The Nonresident Monitor searches COMBLK when it 
finds no match for a typed command in its own Command Table. Figure 
5-1 illustrates the organization of COMBLK. The System Generator adds 
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TABLE 5-1 



.SCOM Registers 



REGISTER BIT 



MEANING 



First register below the Bootstrap (set by the 
System Loader Interface) 



First register above the Resident Monitor (set by 
the System Loader Interface) 



Lowest free register available for storage (set 
by the System Loader or the Linking Loader) 



Highest free register available for storage (set 
by the System Loader, the Linking Loader or DDT) 



Initialized from SGNBLK values by the "first time" 
section of the System Loader Interface Routine, 
and by the LOGIN, LOGOUT and MICLOG logic of the 
Nonresident Monitor; modified by the Nonresident 
Monitor, unless otherwise indicated. 



= 1 



API is available. 



1 = 1 



EAE is available (always set) 



2 = 1 



Teleprinter is Model 35 or 37 



3=1 



Nonresident Monitor is in core 



4,5 



Reserved 



6 = 1 



9-Channel Magnetic Tape System 



7 = 1 



Page Mode Operation 



8=1 



QAREA inadequate for current core size (set by 
the System Loader Interface Routine) 



9 = 1 



DOS disk file structure (always set) 



l)2f = 1 



RBJ2f9 disk is system device. 



11 = 1 



Bank Mode System 



12,13 



Line Printer Line Size 

jHfH No Line Printer 

iari 8^ Characters 

lj2f 12jd Characters 

11 132 Characters 



14 = 1 



Background/Foreground System (always clear) 



15- 17 



Drum size (ignored — DOS does not support drum) 



5-2 







TABLE 5-1 (Cont'd) 


REGISa 


1 

^ER BIT 


MEANING 


5 




Core Image System Program starting address. 


6 


= 1 


DDT in core. 


1=1 


GLOAD 


2 = 1 


DDTNS 


3-17 


User program starting address. 
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When using the Linking Loader, .SCOM+7, 10 and 11 
contain the handler numbers for handlers needed by 
the Linking Loader in .DAT -1, -4, and -5 respect- 
ively. 

When using EXECUTE, 7-11 contain the .SIXBT repre- 
sentation of the name and extension of the Execute 
File, 

When using QFILE (for implementation of .GET, .PUT 
and the Nonresident Monitor GET and PUT commands) , 
7-11 contain the .SIXBT representation of the name 
and extension of the core image file. 


12 




API Level 4 service routine entry point 


13 




API Level 5 " 


14 




API Level 6 


15 




API Level 7 


16 




Program Counter on Keyboard Interrupts. 


17 




AC on Keyboard Interrupts . 


2pr 


= 1 


2^K or 28K system. 


3-17 


First free address in top page. 


21 




Magtape Status Register. 


22 




Reserved for Magtape Handler. 


23 




Pointer to .DAT+|2f. 


24 




Number of positive .DAT slots. 


25 




Pointer to .UFDT+0. 


26 




Number of buffers. 


27 




Number of words per buffer. 


31? 




Pointer to Buffer Transfer Vector Table. 
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TABLE 5-1 (Cont'd) 



REGISTI 


1 

]RS BIT 


MEANING 


31 




Pointer to first entry in the Overlay Table (zero, 
if none) . 


32 




Bad block number on lOPS 2^ and 72. 


33 




CTRL X status register. 


J? = 1 


HALF ON 


1 = 1 


Display Buffer already set up. 


2 = 1 


VT ON 


17 = 1 


If VT ON, display mode is on. 


34 




If in BOSS mode, elapsed time in seconds. 


35 




Instruction to clear TT Busy Switch. 


36 




Number of Entries in the Mass Storage Busy Table. 


37 




Entry point for Expanded Error Processor. 


4(? 




JMP to Expanded Error Processor. 


41 




The logged-in UIC. 


42 




Bit Register. 


^ = 1 


MICLOG successful. 


1 = 1 


.EXIT from Nonresident Monitor. 


2 = 1 


.OVRLA from Nonresident Monitor. 


3 = 1 


LP ON — LPA to .DAT-12 when loading Nonresident 
Monitor. 


4 = 1 


Dump core on calls to .MED (except lOPS 4) . 


5 = 1 


Halt on calls to .MED (except lOPS 4) . 


6-13 


Unused. 


14 = 1 


Set up .DAT+6 (used by BOSS Mode). 


15 = 1 


Load System Device Handler into .DAT-7. 


16 = 1 


KEEP ' ON . 


17 = 1 


BOSS Mode. 


43,44 




•SIXBT Representation of the name of the core 
image system program to be loaded (if any) . 


45,46 




.SIXBT Representation of the name of the Non- 
resident Monitor 
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TABLE 5-1 (Cont'd) 



regis: 


1 

rERS BIT 


MEANING 


47 




Date (MMDDYY) 


5j2 




Time (HHMMSS) 


51 




Elasped time, in ticks. 


52 




BOSS Bit Register 


j3f = 1 


B0SS15 Mode. 


1 = 1 


Control Card Read by user, 5/7 ASCII image saved 
in first block of NRBOSS. 


2 = 1 


Resident BOSS reached "EOF" on run time file (RTF) . 


3 = 1 


User exceeded time estimate. 


4 = 1 


I/O CAL to go to TTY. 


5 = 1 


Terminal lOPS error by user. 


6 = 1 


QDUMP to be given to user on lOPS errors . 


7 = 1 


Operator abort (Control T) . 


8 = 1 


Job active . 


9 = 1 


Exit from B0SS15 Mode. 


10 = 1 


User tried to do a .PUT. Core will be dumped and 
a listing given on LP. 


11 = 1 


User tried to do a .GET. 


12 


Not defined. 


13 


Not defined. 


14-16 


.SYSLD error number. 


17 = 1 


Job abort. 


53 




Reserved for CTRL X code. 


54 




Default Protection Code. 


55 




Entry to Monitor TRAN routine. 


56 




Two's complement of time limit, in seconds (zero, 
if no limit) . 


57 




System Device Code, for use by the Linking Loader. 


6jaf 




Number of ticks until clock interrupt specified 
in last .TIMER (zero, if .TIMER not in use). 
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TABLE 5-1 (Cont'd) 



REGISTER 


BIT 


MEANING 


61 




.TIMER address. 


62 




Address of the first word in the Mass Storage Busy 
Table. 


63 




Number of words per Mass Storage Busy Table Entry. 


64 




JMP to CTRL Q GET routine. 


65 




QFILE Communication Register. 


66 




First Block of the CTRL Q Area. 


67 




Starting Address minus one of the CTRL Q Area. 


7j? 




Two's complement of number of word in Qdump 


71 




Starting Address after DUMP or GET. 


72 




Starting Address after CTRL Q. 


73 




Two's complement of the number of ticks left in the 
next second. 


74 




Two's complement of the line frequency. 


75 




Number of RTF Lines (for BOSS Mode). 


76-ljaf5 




Unused. 
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Word # 


Value 


Descriptioa 




91 


ja(^J?nnn 


Pointer to first free word after SYSBLK 




• 




(There is one set of seven words/core 
image program. ) 




7N+1 


. SIXBT 






7N+2 


.SIXBT 


Name of System Program or overlay 




S 


7N+3 


nnnnnn 


Number of first block on system device 




Y 






occupied by this program or overlay. 




7N+4 


j2fj2fJ3f^nn 


Number of blocks occupied by this pro- 




S 






gram or overlay 




B 


7N+5 


adcires 


Thirteen-bit first address for this 








program or overlay 




L 


7N+6 


pfnnnnn 


Program size 


\ 


r V 


7N+7 


addres 


Thirteen-bit starting address for this 


* iN. 


. 


• 


program or overlay 


(free area) 




59191 


r 


^j2fi2(^pfl{2f 


Number of words in this entry (in this 
case, I9I) 




5911 




.SIXBT 


Name of this system program (left- 




S9f2 p 


.SIXBT 


justified and zero-filled) 




5^3 


.SIXBT 


Name of an overlay (left- justified and 




5pf4 ^ 


.SIXBT 


zero-filled) — overlays are optional 




5i?5 o-< 


JII09IJS9I2 


Number of buffers required by this sys- 


A r" 






tem program (Bits ^-6 = J? means the end 


t 


1 >-- 


? 




of any overlay names. This is why pro- 







1 




gram and overlay names must be left- 




M 








justified. ) 




5pf6 




.DAT&777 


Active .DAT slot 




B 


5i2f7 




^ .DAT&777 


Active .DAT slot (Note: 777777 for a .DAT 




T 




^ 


slot means all positive .DAT slots.) 




L 


51j? 




0f{afj3)?pr5 


Number of words for this entry (in this 




K 


P 




case, 5) 




511 
512 ^ 


.SIXBT 
.SIXBT 


Name of this system program 




513 0^ 


i?J?J?J2fj2fl 


Number of buffers required by this pro- 
gram (Note that his program has no over- 




9 




lays. ) 




514 : 


> 


.DAT&777 


.DAT slot for this program 




111 


|?j2f^5|2(J? 


Pointer to first word in COMBLK (equals 
count from first word in SYSBLK) . The 
two contiguous blocks on the system de- 
vice that hold SYSBLK and COMBLK are 
treated by the system as one large block. 
In this case, COMBLK happens to start at 
location 5^0 of the two blocks combined. 



Figure 5-1 
SYSBLK and COMBLK 
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names of core-image system programs by making them the new' first entry. 
In this way, SYSBLK and COMBLK build toward the center. 

5.2.3 SGNBLK 

SGNBLK (block 36 on the system device) contains all the system param- 
eters not directly associated with core-image system programs. The 
bulk of SGNBLK is concerned with I/O (.DAT slots, .UFDT slots. Skip 
Chain Order, Handlers, and skip lOT codes and mnemonics). The first 
few registers hold such important system information as the system de- 
vice, .SCOM+4 contents, and so on. The very first word in SGNBLK 
points to the block address of the first free word after SGNBLK. The 
next entry is an offset word indicating the total length (including 
itself) of the miscellaneous system parameter table to follow. This 
table includes the size of the .DAT and the size of the skip chain. 
The end of the handler and skip lOT table is the first free entry of 
the block. 

The .DAT slot table corresponds to the legal range of .DAT slots, 
with the maximum negative set to -15 and the maximum positive set to 
a number not to exceed 77_. The .DAT slots are in the form in which 
they appear when the Nonresident Monitor is in core. That is, the 
unit number is in bits ^-2, and the number of the handler right- 
justified in bits 3-17. The handler number for the first handler in 
the Device Handler-Skip lOT Table is zero, for the pseudo-handler NON. 
TTA. is one, and so on. The constant l)?J?j3(j?j? indicates a fixed or il- 
legal .DAT slot (such as -2, -3, and j?) . DOSGEN will not modify such 
slots. 

The .UFD Table is in one-to-one correspondence with the .DAT slot Table, 
An entry of .SIXBT 'UIC' indicates that the logged in UIC is to be sub- 
stituted for the name UIC in the table. An entry of .SIXBT 'SYS' in- 
dicates BNK or PAG is to be substituted, in accordance with the current 
addressing mode. Otherwise, the contents of each location will be the 
.SIXBT representation of the corresponding .UFD slot. 

The Skip Chain Table lists the system skip lOT's in order. A negative 
skip (one that skips on "off", not "on") is represented in one's com- 
plement. Not all skips in the handler Skip lOT Table (described be- 
low) need to be included in the Skip Chain Table. 
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The Device Handler/Skip lOT Table contains all the handler names and 
skip lOT numbers and mnemonics for each I/O device identified to the 
system. Every such device has an entry in the table. A handler name 
must be exactly three characters in length, with the last character 
not an octal digit. The device code for a device is exactly two 
characters. The first two characters of each handler name for a de- 
vice must be the device code. This fact is essential for understand- 
ing the format of a device entry, since the device code is never 
stored as such in an entry, but is inferred from the device handler 
name. The typical entry for a device is the following: 

1. The first words of an entry contain the handler names 
for a device in .SIXBT. Each handler name is differ- 
ent, and the end of the list of handlers is determined 
by a word with zeros in bits |2f-5 (the first character 
position) . 

2. The word that terminated the list of handler names 
contains the number of skip lOT's for the device. 

For each skip lOT, there are three words in the table: 
two for the skip mnemonic and one for the actual code . 

The next device entry follows the last skip for the previous device. 
Handlers may be entered without any skips, but no devices may be 
entered without at least one handler name. Figure 5-2 illustrates 
the organization of SGNBLK. Appendix D of SGEN-DOS Utility Programs , 
DEC-15-YWZB-DN12, lists SGNBLK, SYSBLK and COMBLK, as they are supplied 
by Digital Equipment Corporation. 

5.3 DISK-RESIDENT CHANGING BLOCKS 

The System Loader uses block 37 of the system device to store an image 
of .DAT and .UFDT. Other disk-resident changing blocks are the storage 
Allocation Table and the Bad Allocation Table. These tables are de- 
scribed in Chapter 6. 

5.4 TEMPORARY TABLES BUILT FROM DISK-RESIDENT TABLES 
5.4.1 The Overlay Table 

The System Loader builds the Overlay Table from the entries in SYSBLK 
referenced by a core-image system program's entry in COMBLK. That is, 
the Overlay Table contains an entry for the system program itself, and 
one for each of its overlays. Figure 5-3 illustrates the foimat of an 
entry in the Overlay Table. The first entry in the Overlay Table is 
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Location 

1 
2 



5 
6 

7 

II? 
11 
12 
13 
14 
15 

16 



53 

54 



111 
112 



137 
14)? 



Value 
^00nnn 

{?jar(afjari5 

^^|?nnn 



{af4i3i?jaf 
pf42j?0iaf 

nnnnnn 
nnnnnn 
nnnnnn 
nnnnnn 
.SIXBT 
nnnnnn 
J3fj2f0i?0n 
00nnnn 
7777nn 

{afj?J?nnn 



i3f00nnn 
.SIXBT 



.SIXBT 
nnnnnn 



nnnnnn 
.SIXBT 



.SIXBT 
. SIXBT 



.SIXBT 

nnnnnn 
nnnnnn 
nnnnnn 
.SIXBT 
J2fj?J?J?J2fl 
nnnnnn 



312 



Description 

Pointer to first free entry in SGNBLK 
Number of miscellaneous parameters 
Size of .DAT plus size of .UFDT = (number of posi- 
tive .DAT slots+16)*2. (Initial value is 2j2f posi- 
tive .DAT slots.) 
Number of skips in Skip Chain 

System device code in .SIXBT 

Original contents of .SCOM+4 

Original contents of .SCOM+2J3f 

Number of words per buffer (.SCOM+27) 

Default number of buffers (.SCOM+26) 

Monitor Identification Code 

Information on VT and CTRL X (.SCOM+33) 

Default files protection code (.SCOM+54) 

Size of the Resident Monitor Patch Area 

Minus the number of clock ticks in a second (-74 

for 6J? hz, -62 for 5jy hz.) 

Device assignments for the .DAT (made by handler 
numbers) . (Termination at 53 assumes 2|? positive 
slots. ) 



UIC assignments for the .UFDT. 
Ill assumes 2j2f positive slots. 



(Termination at 



Skip Chain Table (Negative skips in one's comple- 
ment.) (Termination at 137 assumes 22 skips in 
chain . ) 

The last part of the SGNBLK is the Device Handler- 
Skip lOT Table. Each entry starts with the .SIXBT 
representations of all handlers for a particular 
device. (First two characters equal device code, 
for all handlers.) Zeros in the first six bits 
of a word indicate the end of the handler names , 
and says that the rest of the word contains the 
number of skips for this entry's device. The skip 
lOT's follow immediately. As above, one's comple- 
ment skips indicate negative skips. Note, however, 
the confusing fact that a one's complement of a 
skip lOT is a positive number. Thus, 70fnnn com- 
plemented is (3f7nnnn. 



SGNBLK ends at 312, in the DOS-15 system distrib- 
uted by Digital Equipment Corporation, 



Figure 5-2 
SGNBLK 
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pointed to by .SCOM+31. .SCOM+31 will contain zero, if there are no 
entries in the Overlay Tal)le. This will occur during Linking Loader 
or EXECUTE loads. 

.OVRLA is the only Monitor function that looks at the Overlay Table. 
If the .OVRLA processor finds a match to the .OVRLA argument in the 
Overlay Table, it uses the parameters listed in the table to bring 
it in via a Monitor TRAN. Note that this bypasses the System Loader, 
and does not change the handler load. Thus, the overlay must use only 
those .DAT slots required by the original program, the one listed in 
COMBLK. 

If the .OVRLA processor does not find a match in the Overlay Table, it 
calls in the System Loader, which searches COMBLK for the requested 
program. This type of overlay request does not require that .DAT slot 
assignments be the same. On the other hand, the System Loader refreshes 
all of core except .SCOM, etc. Thus, communication between overlays 
is more difficult. The resident patch area, however, can be used for 
this purpose. 

5.4.2 The Device Table 

The Device Table is built by the System Loader interface whenever PIP 
is being loaded, or when PIP is listed in COMBLK among the overlays 
for a program. It is located just above the register pointed to by 
.SCOM+1, and has an entry for each positive .DAT slot. If a slot has 
an assigned device, the low-order twelve bits of the corresponding 
entry in the Device Table will contain the device's code, in .SIXBT. 
Bit 3 is set when the slot is busy. If no device is assigned to a 
slot, the corresponding entry in the Device Table will contain zero. 

5.4.3 The Input/Output Communication (IOC) Table 

The System Loader Interface builds the IOC Table and locates it just 
below the first register of the System Loader. It contains an entry 
for each handler in the system, in the order that they appear in 
SGNBLK. The entries themselves contain the handler name in Radix 5^. 
The System Loader and the Linking Loader use the handler number sup- 
plied by the Nonresident Monitor to index down the IOC Table. They 
use the contents of the entry for a .SEEK to the lOS UIC. 
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5.4.4 The Device Assignment Table (.DAT) 

The Device Assignment Table makes the association between logical and 

physical devices. The Monitor knows its location by the contents of 

th . . 

.SCOiyn-23, which points to the zero entry in the Table. Specific slots 

are found by indexing on the contents of ,SCOM+23. The number of nega- 
tive slots is fixed at ISq. The number of positive slots is specified 

o 

by .SCOM+2 4, and may be any positive number less than lj?0g<. It is 
specified at system generation time. 

The Nonresident Monitor places the handler number in the low order 
bits and the unit niimber in the high order bits. It derives the hand- 
ler number from SGNBLK. As mentioned above, the System Loader and 
the Linking Loader subsequently use the IOC Table to determine the 
handler name. After either loader has loaded and relocated a handler, 
it places the handler's starting address in all .DAT slots that refer- 
ence that handler. The unit number remains in the high-order three 
bits. Slots with no handler (NON) contain zero. Active .DAT slots 
are designated by COMBLK, for core-image system programs, and by . lODEV 
pseudo-ops for the Linking Loader and EXECUTE. 

5.4.5 The User File Directory Table (.UFDT) 

.UFDT+j2f is offset from .DAT+^ (pointed to by .SCOM+2 3) by the sum of 
the positive and negative .DAT slots. Each .DAT slot has a correspond- 
ing .UFDT slot. UIC's in the .UFDT are packed in .SIXBT. The address 
of .UFDT+J2( is stored in .SCOM+25. 

5.4.6 The Skip Chain 

Register 1 of Bank ^ contains a jump to the beginning of the Skip 
Chain. The Skip Chain is defined during System Generation, is located 
in SGNBLK, and is rebuilt every time the System Loader is called in. 
The System Generator Manual (DEC-15-YWZB-DN12) describes considerations 
for constructing the Skip Chain. 

5.5 TEMPORARY TABLES BUILT FROM SCRATCH 
5.5.1 File Buffer Transfer Vector Table 

The System Loader allocates space for the buffer pool, and creates the 
File Buffer Transfer Vector Table. .SCOM+30 points to the first entry 
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in the table, and the number of entries is specified by .SCOM+26. 
Each entry in the table contains the address of a buffer, or its one's 
complement. Negative addresses indicate a busy buffer. Since refer- 
ences to buffers must be indirect anyway, buffers are allocated with- 
out regard to bank boundaries. 

5.5.2 The RCOM Table 

The Nonresident Monitor requires certain information about the Resi- 
dent Monitor that does not warrant reserving additional .SCOM registers 
The System Loader therefore puts this information into the RCOM table, 
whenever it is loading the Nonresident Monitor. The RCOM Table starts 
at register 115^^ of the highest bank. 

5.5.3 The Mass Storage Busy Table 

Entries in this table are allocated by the System Loader or the Link- 
ing Loader. The Mass Storage Busy Table is pointed to by .SCOM+6 2. 
.SCOM+6 3 contains the number of words per entry in the table, and 
.SCOM+36 contains the current number of entries. Generally speaking, 
there are as many entries in the Busy Table as there are active .DAT 
slots, although the disk handlers are the only ones that currently 
refer to the Busy Table. 

The .INIT command to a disk handler establishes a Busy Table entry. 
The .CLOSE command (or the Rewind .MTAPE command) deletes the corres- 
ponding entry. Figure 5-4 illustrates a typical Busy Table Entry. 

The first word of an active entry in the Busy Table contains the .DAT 
slot in bits 9-17. The disk handlers save information about the UFD 
current for this .DAT slot in the Mass Storage Busy Table. They save 
information about the file current to the .DAT slot (if any) in the 
buffer pointed to by word 1 of the Busy Table Entry. More information 
on the disk handlers and file structure is contained in Chapter 6. 



5.6 RESERVED WORD LOCATIONS 

Word locations through 77 are dedicated systems locations and can- 
not be employed by the user. The contents of these locations are 
described in Table 5-5. 
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Word # 


Contents 


N,N+1 


•SIXBT name of Overlay 


N+2 


First block number 


N+3 


First address, minus 1 


N4-4 


Size, in two's complement 


N+5 


Fifteen-bit starting address 



Table 5-3 Overlay Table 



Word # 



N 

N+1 

N+2 

N+3 

N+4 



Contents 



Device Type^_2 , Unit Number^^^, Write Cheeky , .DATg_ 

Buffer Address, or j?, if none allocated 

Three-character UIC 

First UFD block for this UIC 

UFD Entry size for files in this UFD 



Table 5-4 Mass Storage Busy Table Entry 



ADDRESS 


USE 


9S 


Stores the contents of the extended PC, link, extend 
mode status, and memory protect status during a pro- 
gram interrupt 


1 


EEM (for PDP-9 compatibility) 


2 


JMP to Skip Chain 


3 


.MED, entry to Monitor Error Diagnostic routine 


4 


JMP to error handler 


5 


Stores system type (Bank or Page) indicator during 
Teletype interrupts 


6 


Used for API ON/OFF indicator 


7 


Stores real time clock count 


10-17 


Autoindex registers 


20 


Stores the contents of the extended PC, link, mode 
status, and memory protect status on a CAL instruc- 
tion. 


21 


JMP to CAL handler 


22-37 


Seven pairs of word counter-current address registers 
for use with 3-cycle I/O device data channels. 


40-77 


Store unique entry instructions for each of 32 „ auto- 
matic priority interrupt channels 



Table 5-5 Reserved Address Locations 
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5.7 BOOTSTRAP NON-BOSS BATCH BITS 

The high-order three bits of word 11111 in the Bootstrap are reserved 
for the Monitcr, and have the following meanings: 

Bit 1 = In non-BOSS Batch Mode 
= Not in non-BOSS Batch 

Bit 1 1 = $JOB ASCII line or card just read by batch device 
= Last line or card not $JOB 

Bit 2 1 = Batch device is card reader 

2 = Batch device is paper tape reader 
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CHAPTER 6 



FILE STRUCTURES 



6.1 DECTAPE FILE ORGANIZATION 

DECtape can be treated either as a directoried or non-directoried 
device. 

6.1.1 Non-Directoried DECtape 

A DECtape is said to be non-directoried when it is treated as magnetic 
tape by issuing the .MTAPE commands: REWIND, BACKSPACE, followed by 
.READ or .WRITE. No directory of identifying information of any kind 
is recorded on the tape. A block of data (255^^ word maximum), exactly 
as presented by the user program, is transferred into the handler buf- 
fer and recorded at each .WRITE command. A .CLOSE terminates record- 
ing with a software end-of-file record consisting of two words: 001005, 
776773 

Because braking on DECtape allows for tape roll, staggered recording 
of blocks is employed in DOS to avoid constant turnaround or time- 
consuming back and forth motion of physically sequential block record- 
ing. When recorded as a non-directoried DECtape, block J3 is the 
first block recorded in the forward direction. Thereafter, every fifth 
block is recorded until the end of the tape is reached, at which time 
recording, also staggered, begins in the reverse direction. Five 

passes over the tape are required to record all 1100^ blocks. 

o 

6.1.2 Directoried DECtape 

Just as a REWIND or BACKSPACE command declares a DECtape to be non- 
directoried, a .SEEK or .ENTER implies that a DECtape is to be con- 
sidered directoried. A directory listing of any such DECtape is 
available via the (L)ist command in PIP. A fresh directory may be 
recorded via the N or S switch in PIP. 

The directory of all DECtapes except system tapes occupies all 4|?j2f_ 
words of block Ij^^^o* ^t is divided into two sections: (1) a 40- word 
Directory Bit Map and (2) a 340 word Directory Entry Section. 



6-1 



The Directory Bit Map defines block availability. One bit is allo- 
cated for each DECtape block (llOOg bits = 40g words). When set to 1, 
the bit indicates that the DECtape block is occupied and may not be 
used to record new information. 

The Directory Entry Section provides for a maximum of 56^ ^ files on 
a DECtape. Each file on the DECtape has a four-word entry. Each 
entry includes the three-word file name and extension, a pointer to 
the first DECtape block of the file, and a file active or present bit. 
Figure 6-1 illustrates the DECtape directory. 



Word 


t 

37 
40 



377 



'Block p 



Block Ij2f77 



Entry ^ 



Entry 55 



1^ 



Directory 
Bit Map 



Directory 

Entry 

Section 



Wd. 
1 
2 
3 



9 


5 6 11 12 


17 


File 


Name 


File Name Extension 


1 


Data Link (First File 


Block) 



Note: Nulls (0) fill 
in short file names. 
A file name extension 
is not absolutely 
necessary. 



Sign Bit: 1 = File Active 
A DIRECTORY ENTRY 

Figure 6-1 

DECtape Directory 

Additional file information is stored in blocks 71 through 7 7 of every 
director ied DECtape. These are the File Bit Map Blocks. For each file 
in the directory, a 4 0g-word File Bit Map is reserved in block 71 
through 77. The bit maps are contiguous, and the N file uses the 
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N bit map. Each block is divided into eight File Bit Map Blocks. A 
File Bit Map specifies the blocks occupied by that particular file and 
provides a rapid, convenient method to perform DECtape storage re- 
trieval for deleted or replaced files. Note that a file is never de- 
leted until the new one of the same name is completely recorded on 
the .CLOSE of the new file. When a fresh directory is written on 
DECtape, blocks 71 through 100 are always indicated in the Directory 
Bit Map as occupied. Figure 6-2 illustrates DECtape file bit maps. 



Block 71 



Block 72 



8 



8 



Block 77 



8 



Bit 


Map 


for 


File 





Bit 


Map 


for 


File 


7 


Bit 


Map 


for 


File 


8 


Bit 


Map 


for 


File 


^h^ 


• 


Bit 


Map 


for 


File 


'h^ 


Bit 


Map 


for 


File 


''l0 



Figure 6-2 



DECtape File Bit Map Blocks 



Staggered recording (at least every fifth block) is used on directoried 
DECtapes, where the first block to be recorded is determined by examina- 
tion of the Directory Bit Map for a free block. The first block is 
always recorded in the forward direction; thereafter, free blocks are 
chosen which are at least five beyond the last one recorded. The last 
word of each data block recorded contains a data link or pointer to 
the next block in the file. When turnaround is necessary, recording 
proceeds in the same manner in the opposite direction. When reading, 
turnaround is determined by examining the data link. If reading has 
been in the forward direction, and the data link is smaller than the 
last block read, turnaround is required. If reverse, a block number 
greater than the last block read implies turnaround. 

A software end-of-file record (001005, 776773) terminates every file. 
The data link of the final block is 777777. 
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Data organization for each I/O medium is a function of the data modes. 
On directoried DECtape there are two forms in which data is recorded: 
CD packed lines - lOPS ASCII, lOPS Binary, Image Alphanumeric, and 
Image Binary, and (2) dump mode data - Dump Mode. 

In lOPS or Image Modes, each line (including header) is packed into 
the DECtape buffer. In lOPS Binary, a 2's complement checksum is com- 
puted and stored in the second word of the header. When a .WRITE 
which will exceed the remaining buffer capacity is encountered, the 
buffer is output, after which the new record is placed in the empty 
buffer. No record may exceed 254 j^_ words, including header, because 
of the data link and even word requirement of the header word pair 
count. An end-of-file is recorded on a .CLOSE. It is packed in the same 
manner as any other line. 



In Dump Mode, the word count is always taken from the I/O macro. If 
a word count is specified which is greater than 255, q (note that space 
for the data link must be allowed for again) , the DECtape handler will 
transfer 255^^ word increments into the DECtape buffer and from there 
to DECtape. If some number of words less than 255^^ remain as the 
final element of the Dump Mode .WRITE, they will be stored in the DEC- 
tape buffer, which will then be filled on the next .WRITE, or with an 
EOF if the next command is .CLOSE. DECtape storage is thus optimized 
in Dump Mode since data is stored back-to-back. See Appendix A. 

6.2 MAGNETIC TAPE 

DOS provides for industry-compatible magnetic tape as either a di- 
rectoried or non-directoried medium. The magnetic tape handlers com- 
municate with a single TC-59D Tape Control Unit (TCU) . Up to eight 
magnetic tape transports may be associated with one TCU; these may 
include any combination of transports TU-lOA or B and TU-30A or B. 

There are a number of major differences between magnetic tape and DEC- 
tape or Disk; these differences affect the operation of the device 
handlers. Magnetic tape is well suited for handling data records of 
variable length. Such records, however, must be treated in serial 
fashion. The physical position of any record may be defined only in 
relation to the preceding record. Three techniques available in I/O 
operations to block-addressable devices are not honored by the magnetic 
tape handlers: 
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a. The user cannot specify physical block numbers for 
transfer. In processing I/O requests that have block 
numbers in their argument lists (i.e., .TRAN) the 
handler ignores the block-number specification. 

b. The only area open for output transfers in the direc- 
toried environment is that following the logical end 
of tape. 

c. Only a single file may be open for transfers (either 
input or output) at any time on a single physical unit, 



6.2.1 Non-directoried Data Recording (MTF) 

MTF is intended to satisfy the requirements of the FORTRAN programmer 
while still providing the assembly language programmer maximum freedom 
on the design of his tape format. MTF writes out a record to the tape 
each time the main program issues a .WRITE. The length of the record 
is always two times the word pair count in the header word pair. FIOPS 
records are always as long as the buffer size returned on a .INIT (up 



to 256, ^ words) . 



MTF returns a standard buffer size of 377o/ after a 

o 



.INIT. The FORTRAN user may dynamically change this size, however, 
via the following instructions. 

(FORTRAN STATEMENTS) (MACRO STATEMENTS) 



CALL SETMTB (ISIZE) 





.TITLE 


SETMTB 




. GLOBL 


.DA, MTBSIZ, SETMTB 


SETMTB 









JMS* 


.DA 




JMP 


START 


BUFSIZ 







START 


LAC* 


BUFSIZ (any buff 




DAC* 


MTBSIZ 




JMP* 


SETMTB 




.END 





6.2. 2 



Directoried Data Recording (MTA. , MTC.) 



The programmer can make the fullest possible use of those features 
peculiar to magnetic tape by using MTF. On the other hand, MTF does 
not offer the powerful file-manipulation facilities available in the 
system. Directoried I/O allows device independence, and extensive 
use of the storage medium with a minimum of effort. 
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Every block recorded by MTA. (with the exception of end-of-file markers, 
which are hardware-recorded) includes a two-word Block Control Pair 
and not more than 255,^ words of data. The data will contain the 
records from one or more .WRITE 's. 

The Block Control Pair serves three functions: it specifies the char- 
acter of the block (label, data, etc.), provides a word count for the 
block, and gives an 18-bit block checksum. The Block Control Pair has 
the following format: 



Word 1 : 

Bits through 5: Block Identifier (BI). This 6-bit byte 
specifies the block type. Values of BI may range from 
to 77q. Current legal values of BI , for all user files, 
are as follows: 



BI Value 

00 
10 
20 



Block Type Specified 

User-File Header Label 
User-File Trailer Label 
User-File Data Block 



Bits 6 through 17: Block Word Count (BWC) . This 12-bit 

byte holds the 2's complement of the total number of words 

in the block (including the Block Control Pair) . Legal 
values of BWC range from -3 to -40 1_. 

Word 2: 



Bits through 16: Block Checksum. The Block Checksum is 
the full-word, unsigned, 2's complement sum of all the 
data words in the block and word 1 of the Block Control 
Pair. 



BCP WORD I 
8CP WORD 2 



N-2 DATA / 
WORDS "S 



I I I I I 

BLOCK ID 

I I I I I 



I I I I I I I I I I I 



■f+ 



■BLOCK CHECKSUM- 



I I I I I I I I I I ' 



N TOTAL WORDS 
IN BLOCK 



Figure 6-3 



Block Format, File-Structured Mode 
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One of the main file functions of MTA. and MTC. is that of identifying 
and locating referenced files. This is carried out by two means: 
first, names of files recorded are stored in a file directory at the 
beginning of the tape; and second, file names are contained in the 
file's header and trailer labels. 

6.2.2.1 Magnetic Tape File Directory 

The directory, a single-block file (and the only unlabeled file on any 
file-structured tape) , consists of the first recorded data block on 
the tape. It is a 257, « word block with the following characteristics: 

a. Block Control Pair (words 1 and 2) 

Word 1 

Block Identifier = 74 = File Directory Data Block 
Block Word Count = -401g = 7377g. 

Word 2: 

Block Checksum: As described above. 

b. Active File Count (Word 3, Bits 9 through 17) 9-bit one's 
complement count of the active file names present in the 
File Name Entry Section (described below) . 

c. Total File Count (Word 3, Bits through 8) 9-bit one's 
complement count of all files recorded on the tape, in- 
cluding both active and inactive files, but not the file 
directory block. 

d. File Accessibility Map (Words 4 through 17) : The File 
Accessibility Map is an array of 252nQ contiguous bits 
beginning at bit of word 4 and ending as bit 17 of 
word 17. Each of the bits in the Accessibility Map re- 
fers to a single file recorded on tape. The bits are 
assigned relative to the zero'^^ file recorded; that is, 
bit of word 4 refers to the first file recorded; bit 
1, word 4, to the second file recorded; bit 0, word 6, 
to the 37^0^^ file recorded; and so on, for a possible 
total of ^52-,Q files physically present. 

A file is only accessible for reading if its bit in the 
Accessibility Map is set to one. A file is made inac- 
cessible for reading (corresponding bit =0) by a .DLETE 
of the file, by a .CLOSE (output) of another file of the 
same name, or by a .CLEAR. A file is made accessible for 
reading (corresponding bit =1) by a .CLOSE (output) of 
that file. Operations other than those specified above 
have no effect on the File Accessibility Map. 



6-7 



BIT POSIT ION 



BCP 



FILE COUNTS 



FILE 

ACCESSI 8 I L I TY 

MAP 



FILE 

NAME 

ENTRY , 

SECTION 












3 




6 


9 


12 




15 17 


WORD 1 


7 


4 


7 


3 


7 


7 


WORD 2 


BLOCK CHECKSUM 


WORD 3 


7 


7 


2 


7 


7 


4 


WORD 4 


01011 


CONTENTS /// 
UNSPEC IFIED /// 


1 


WORD 1 6 
WORD 1 7 


^ 


/ 
/ 
/ 
/ 
/ 
/ 
/ 
/ 






WORD 18 








F 


I 




L 












E 


# 




2 












E 


X 




T 




WORD 2 1 








F 


I 




L 












E 


# 




4 












E 


X 




T 




WORD 24 








F 


I 




L 












E 


# 




5 












E 


X 




T 




WORD 25 7 


^ 


/ 
/ 
/ 
/ 
/ 
/ 
/ 
/ 


// 


7/. 


CONTENTS ^ 
UNSPECI FIED 


/ 

/ 
/ 
/ 
/ 
/ 
/ 
/ 


P 


^ 
:^' 



BEGINNING 
OF TAPE 



FILE 
D I RECTORY 



FILE #1 
(I NACTIVE) 



FILE #2 
(ACTIVE) 



FILE #3 
(INACTIVE) 



FILE #4 
(ACTIVE) 



FILE #5 
(ACTIVE) 



END OF TAPE 



Figure 6 -4a. Format of the 
File Directory Data Block, 
showing relationship of active 
and inactive files to file name 
entries and to Accessibility Map 



Figure 6-4b. Format of file- 
structured tape, showing 
directory block and data 
files. 
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e. File Name Entry Section (Words 18 through 257): The File 
Name Entry Section, beginning at word 18 of the direc- 
tory block, includes successive 3-word file name entries 
for a possible maximum of 80 entries. Each accessible 
file on the tape has an entry in this section. Entries 
consist of the current name and extension of the refer- 
enced file in .SIXBT (left-adjusted and, if necessary, 
zero-filled) . 

The position of a file name entry relative to the begin- 
ning of the section reflects the position of its accessi- 
bility bit in the map. That bit, in turn, defines the 
position of the referenced file on tape with respect to 
other (active or inactive) files physically present. Only 
active file names appear in the entry section, and access- 
ibility bits for all inactive files on the tape are always 
set to zero; accessibility bits for all active files are 
set to one. 

To locate a file on the tape having a name that occupies 
the second entry group in the File Name Entry Section, 
the handler must (a) scan the Accessibility Map for the 
second appearance of a 1-bit, then (b) determine that bit's 
location relative to the start of the map. That location 
specifies the position of the referenced file relative to 
the beginning of the tape. The interaction of the File 
Name Entry Section and the Accessibility Map are shown 
in Figure 6-4. 

6.2.2.2 User-File Labels 

Associated with each file on tape is one label, the header label. It 
precedes the first data block of the file. Each label is 27^^ words 
in length. Label format is shown in Figure 6-5. 










5 


6 




17 


WORD 1 


00 


^""45 


WORD 2 


CHECKSUM 


WORD 3 


777 XXX 


WORD 4 


000000 


WORD 5 





















WORD 26, 
WORD 27, 



FILE NAME 



> RESERVED 



Figure 6-5 



User-File Header Label Format 
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6.2.2.3 File-Names in Labels 

The handler will supply the contents of the file-name fields (Word 3) 
in labels. These are used only for control purposes during the execu- 
tion of .SEEK's. The name consists simply of the two's complement of 
the position of the recorded file's bit in the Accessibility Map; the 
"name" of the first file on tape is 777777, that of the third file is 
7 77775, and so on. A unique name is thus provided for each file physi- 
cally present on the tape. Since there may be a maximum of 252,. files 
present, legal file-name values lie in the range 777777 to 777404. 

6.2.3 Continuous Operation 

Under certain circumstances, it is possible to perform successive I/O 
transfers without incurring the shut-down delay that normally takes 
place between blocks. The handler stacks transfer requests, and thus 
ensures continued tape motion, under the following conditions: 

a. The I/O request must be received by the CAL handler be- 
fore a previously-initiated I/O transfer has been com- 
pleted. 

b. The unit number must be identical to that of the pre- 
viously initiated I/O transfer. 

c. The I/O request must be one of those listed below to 
ensure successful completion. The handler in process- 
ing requests in continuous mode depends on receiving 
control at the CAL level in order to respond to I/O 
errors. The functions for which continuous operation 
is attempted include only the following: 

1 . . xMTAPE 3 . . WRITE 

2. .READ 4. .TRAN 

d. With MTA, more than one logical record may be in a physical 
block, so tape motion may stop if fewer successive .READ's 
or . WRITE 's are issued than there are records in a block. 

e. The previously-requested transfer must be completed with- 
out error. In general, successive error-free READ'S 
(WRITE' s) to the same transport will achieve non-stop 
operation. The following examples illustrate this prin- 
ciple. 

Example 1: Successful Continued Operation 

SLOT = 1 

INPUT = 

BLOKNO = 

READl .TRAN SLOT, INPUT, BLOCKNO, BUFFI, 25 7 

READ2 .TRAN SLOT, INPUT, BLOCKNO, BUFF 2 , 257 

RETURN JMP READl 
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The program segment in Example 1 will most probably keep the refer- 
enced transport (.DAT slot 1) up to speed. The probability decreases 
as more time elapses between READl and RE AD 2 , and between READ2 and 
RETURN. Each .TRAN request causes an implicit .WAIT until its opera- 
tion is completed. 

Example 2: Unsuccessful Continued Operation 

SLOT = 1 

INPUT = 

BLOKNO = 

READ .TRAN SLOT, INPUT, BLOKNO, BUFF, 257 

STOP .WAIT SLOT 

RETURN JMP READ 

The program segment in Example 2 will not keep the tape moving because 
the .WAIT at location STOP prevents control from returnina to location 
READ until the transfer first initiated at READ has been completed. 

Example 3: Unsuccessful Continued Operation 

SLOTl = 1 

SL0T2 = 2 

INPUT = 

BLOKNO = 

READl .TRAN SLOTl, INPUT, BLOKNO, BUFFI, 25 7 

READ2 .TRAN SL0T2 , INPUT, BLOKNO, BUFF 2 , 257 

RETURN JMP READl 

This program segment will not provide non-stop operation because of 
the differing unit specification at READl and READ 2 . 

6.2.4 Storage Retrieval on File-Structured Magnetic Tape 

The use of a file accessibility map as well as block identifiers in 
Magtape file directories makes it almost impossible to retrieve the 
area of a deleted file from a magnetic tape. The execution of the 
deletion command (i.e., .DLETE) removes the name of the object file 
from the file directory, and clears the corresponding bit in the File 
Accessibility Map. 

The only circumstance under which a file area may be easily retrieved 
is when the deleted file is also the last file physically on the tape. 
Under these conditions, the handler can retrieve the area occupied by 
the deleted file when the next .ENTER - .WRITE - .CLOSE sequence is 
executed. Users may also copy the active files to another device, re- 
new the directory, and recopy the files. 
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6.3 DISK FILE STRUCTURE 

6.3.1 Introduction 

The DOS-15 disk file structure is in some ways analogous to DECtape 
file structure. Ordinarily, each disk user has a directory which 
points to named files, just as each DECtape has a directory. The DEC- 
tape has only one directory, but the disk has as many directories as 
users have cared to establish. A single user's disk directory might 
correspond to a single DECtape directory. A single disk file's size 
is also limited only by the available space, as is true with DECtape. 
Whereas DECtape directories may only reference a maximum of 56, „ files, 
however, the number of files associated with any one directory on the 
disk is limited only by the available disk space. 

The DECtape directory is in a known location — at block 100. Since 
the disk may have a variable number of directories, the Monitor must 
know how to find each user's directory. It therefore maintains a 
Master File Directory (MFD) at a known location^, and the Master File 
Directory points to each User File Directory (UFD) . DOS-15 allows 
only those users who know the Master Identification Code to have ac- 
cess to any protected UFD ' s within the MFD. Figure 6-6 illustrates 
the MFD. Appendix B is a flowchart of the Disk "A" Handlers. 

6.3.2 User Identification Codes (UIC) 

The Monitor finds User File Directories by seeking associated User 
Identification Codes (UIC's), which are all listed in the Master File 
Directory. The UIC is a three-character code that is necessary for 
all non-.TRAN I/O to the disk. .TRAN macros use no directory refer- 
ences. A programmer may operate under as many UIC's as he wishes, pro- 
vided all are unique and none is reserved^ . He may establish a new 
User File Directory by (1) logging in his new UIC to the Monitor via 
the LOGIN command, (2) calling PIP, and (3) issuing an N DK command. 
This establishes a new User File Directory, or refreshes (wipes clean) 
an old directory under that UIC. (.ENTER will also create a new MFD 
entry and/or a UFD, if none exists.) Figure 6-7, User File Directory, 
illustrates the organization of a UFD. 



^On the RF disk, the first block of the MFD is located at block 1777. 
On the RP disk, the first block of the MFD is located at block 47]2l4j2f. 

^The following are reserved UIC's: @@(a, ???, PAG, BNK, SYS, lOS, 
CTP. 
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Word # 
1 



4N 

4N+1 



4N+2 
4N+3 

376 
377 



Contents 



mill 

nnnnnn 
nnnnnn 



4^ „+blknuin 
j3-2 



.SIXBT 
nnnnnn 



spare 

nnnnnn 
nnnnnn 



Description 

Dummy UIC used by system. 

Bad Allocation Table's first block number, 
or mill, if there is none. ' 

SYSBLK's first block number, or -1, if 
there is none. 

MFD entry size in bits 0-2, plus the block 
number of the first submap 



UIC for this UFD 

Block number for the first block of this 

UFD or 777777, if no UFD exists (as after 

pip's Ni_iDK^) 

Protection code in bit J2f, plus the UFD 

entry size for each file 

Unused at this writing 

Pointer to previous MFD block, or 777777 

if no ne . 

Pointer to next MFD block, or 777777 if 

none. 



Figure 6-6 



Master File Directory 



Word # 



8N 

8N+1 
8N+2 
8N+3 

8N+4 
8N+5 

8N+6 



8N+7 

376 
377 



Contents 



.SIXBT 
-SIXBT 
•SIXBT 
Tg+blknum 

nnnnnn 
ribptr 



P0_-[_+ribwrd 



crdate 

nnnnnn 
nnnnnn 



Description 



Name of this file 

and its 

extension 

Truncation code in bit j2f, plus the number 

of tte first block of the file 

Number of blocks in this file 

Pointer to the first block of the Retrieval 

Information Block 

Protection code in bits 0-1, plus the 

first word in ribptr used by the RIB — if 

the last block of the file has room for 

the RIB, the handlers will put it there, 

and load word 8N+6 accordingly. 

Date of file's creation -mmddyy (yy modulo 70) 

Pointer to previous block, or 777777 if none 
Pointer to next UFD block, or 777777 if none 



Figure 6-7 



User File Directory 
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6.3.3 Organization of Specific Files on Disk 

The Disk Handlers write out files in almost the same way that a DEC- 
tape handler does. Disk file blocks, however, have a forward and 
backward link. (Non-dump records are therefore limited to lengths 
of 254^Q words.) Further, upon receipt of a .CLOSE I/O macro, the disk 
handlers fill out a Retrieval Information Block (RIB) . The RIB per- 
forms the same functions as the file bitmap on DECtape, and also as- 
sociates the logical sequence of blocks in the file with the physical 
locations of the blocks on the disk. The disk handler uses the RIB to 
implement .RTRAN commands and to delete files. Figure 6-8, The Retrieval 
Information Block, illustrates a RIB. 

After a user has created a disk file he can access logical records 
sequentially via .READ commands, just as with DECtape files. He can 
also access physical blocks of that file by referencing relative block 
numbers in the .RTRAN command. (The .RTRAN commands require the file 
be opened with the .RAND command.) 

6.3.4 Buffers 

The handlers break buffers from the pool into three parts: (1) File 
Information (about 4^ ^ words)* (2) the Block List — addresses of 
pre-allocated blocks (between 4 and 253, « addresses, inclusive), and 
(3) data buffer (256, ^ words). Figure 6-9, Disk Buffer, illustrates 
the breakdown of disk buffers . 

6.3.4.1 Commands That Obtain And/or Return Buffers 

The following commands obtain buffers from the pool, and return them 
immediately after execution: 

. DLETE 
. RENAM 
.CLEAR 

The following commands obtain a buffer from the pool and do not return 
it until a subsequent .CLOSE is performed: 

.FSTAT 
.ENTER 
.SEEK 
.RAND 



*This n\amber is determined by assembly parameters 
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Word # 


Contents 


Description 


0* 


nnnnnn 




Total number of blocks described by this 
physical block. 


1 
2 
3 


nnnnnn 
nnnnnn 
nnnnnn 




First data block pointer. 
Second data block pointer. 
Third data block pointer. 


376 


nnnnnn 




Pointer to previous RIB block or -1 if no 
previous RIB block. 


377 


nnnnnn 




Pointer to next RIB block or -1 if no 
next RIB block. 


j_T_ •l-'h 

* Zero word of the RIB may not be zero word of physical block. 
This occurs whenever the entire RIB will fit in the last data 
block of the file. 



Figure 6-8 
Retrieval Information Block 



1 
4 0o Words* 


1 


More than 3 and 
less than 377g 
words 


i 
1 


4 0g Words 


I 

r 



File Information becomes 
'Current Set' when file active 
Csee 6.3.4.2) . 



Addresses of Preallocated 
Blocks (Block List or Temp 
List or TLIST) 



Data Buffer 



*This is not a fixed number, 
different for RP and RF. 



It is 



Figure 6-9 
Disk Buffer 
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The following commands return a buffer to the pool, if any was allo- 
cated. 

.INIT 

.CLOSE 

.MTAPE (rewind) 

6.3.4.2 The Current Set 

The handlers retain information about the last file and .DAT slot 
processed in an internal storage area. This area is called the 
"Current Set", and is swapped back to the file's buffer whenever a 
command to a different file is used. Thus, 

.WRITE to .DAT slot A 
.WRITE to .DAT slot B 

will swap the Current Set, but... 

.WRITE to .DAT slot A 
.TRAN to .DAT slot A 
.WRITE to .DAT slot A 

will not swap the Current Set. 

6.3.5 Pre-allocation 

The handlers pre-allocate blocks on the disk upon all .ENTER commands, 
and whenever sufficient .WRITE commands have been issued to use up the 

pre-allocated blocks. The number of pre-allocated blocks will be the 
minimum of the niomber of free blocks on the device and the number of 
address slots available in the Temp List (block list) . 

When the handlers pre-allocate blocks, they fill out the bit maps, and 
immediately fill out the RIB and write it out in one of the pre-allocated 
blocks . 

Upon a .CLOSE command, the handlers give back unused blocks, and re- 
write the RIB. 
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The number of blocks in the Block List depends on the size of the 
buffer, which is determined at system generation by setting the buffer 
size. The larger the Block List, the faster will be output. Smaller 
Block Lists may give more efficient allocation of core and disk space. 
Smaller buffers save core. Further, the number of pre-allocated blocks 
may affect concurrently opened files on a disk that is tight for space. 
Thus, if the Block List is sixty entries long, and there are forty 
blocks left on the disk, a .ENTER to .DAT slot will pre-allocate all 
forty, leaving none for any subsequent .ENTER' s to different .DAT 
slots. 

lOPS 70 will occur when there are less than four free blocks on the 
disk when a handler tries to pre-allocate blocks. 

6.3.6 Storage Allocation Tables (SAT's) 

The disk handlers use a Storage Allocation Table, in order to distin- 
guish between allocated and free blocks. If more than one physical 
block is required, the individual blocks are called Submaps . 

Unlike DECtape , the Storage Allocation Table is never held in core. 
When the handlers wish to preallocate some blocks, they read in the 
required Submap, and write out the updated one. 

Storage Allocation blocks use the following format: 

WORD j? Total blocks on the disk 

WORD 1 Number of blocks described 

by this Submap 
WORD 2 Number of blocks occupied 

in this Submap 
WORD 3 First word of the bit map 

(eighteen blocks per word) 



WORD 376 Pointer to previous Submap 

(or 777777) 
WORD 377 Pointer to next Submap 

(or 777777) 

The bit maps refer to blocks in numerical order. Thus, bit of word 
three of a Submap will refer to block N, bit 1 will refer to block N+1, 
and so on. The block is free if the corresponding bit equals 0. Start- 
ing and ending block numbers for all Submaps are retained in the hand- 
lers. The first Submap, however, starts with block zero. 
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6.3.7 Bad Allocation Tables (BAT's) 

Occasionally, a particular block on the disk will not record data cor- 
rectly. In such instances, the handlers should be prevented from using 
the bad blocks. Accordingly, PIP maintains a Bad Allocation Table. 
Whenever a user updates that table, PIP will set the appropriate bit 
in the Storage Allocation Table. The block is thus made unavailable. 
Refer to PIP manual (DEC-15-VWZB-DN13) for more information. 
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CHAPTER 7 
WRITING NEW I/O DEVICE HANDLERS 



This chapter contains information essential for writing new I/O de- 
vice handlers to work in DOS . 

7.1 I/O DEVICE HANDLERS, AN INTRODUCTION 

All communications between user programs and I/O device handlers are 
made via CAL instructions followed by an argument list. The CAL 
Handler in the Monitor (Figure 2-1) performs preliminary setups, 
checks the CAL calling sequence, and transfers control via a JMP* 
instruction to the entry point of the device handler. When the con- 
trol transfer occurs (see Figures 7-1 and 7-2) , the AC contains the 
address of the CAL in bits 3 through 17 and bits 0, 1, and 2 indicate 
the status of the Link, Bank/Page mode, and Memory Protect, respect- 
ively, at the time of the CAL. Note that the content of the AC at 
the time of the CAL is not preserved when control is returned to the 
user. 

On machines that have an API, the execution of a CAL instruction auto- 
matically raises the priority to the highest software level (level 4) . 
Control passes to the handler while it is still at level 4, allowing 
the handler to complete its non-reentrant procedures before debreaking 
(DBK) from level 4. This permits the handler to receive reentrant 
calls from software levels higher than the priority of the program 
that contained this call. Device handlers which do not contain re- 
entrant procedures (including all handlers supplied with DOS) may avoid 
system failure caused by inadvertent reentries by remaining at level 
4 until control is returned to the user. 

If the non-reentrant method is used, the debreak and restore (DBR) 
instruction should be executed just prior to the JMP* which returns 
control to the user, allowing debreak from level 4 and restoring the 
conditions of the Link, Bank/Page mode, and Memory Protect. Any lOT's 
issued at the CAL level (level 4 if API present, mainstream if no API) 
should be executed immediately before the 

DBR 

JMP* 
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USER PROGRAM 



MONITOR 



CAL 



LOC+0 CAL ARC. 
LOC+1 CODE 



LOC+N NXT INST 



CAL HANDLER 



DEVICE HANDLER 



Save CAL pointer and 
fetch function code 



■ INIT 



Initialize Handler and 
return buffer size 




Issue .SETUP for each 
PI skip or API entry 
vector 




Loop an CAL, or 
return to user 
address, if .WAITR 



I0PS7 



CAL Entry to Device Handler 



Figure 7-1 
7-2 



PI 

ENTRY - 



- via 
JMS 
Skip Chain 
JMP* (INT 



API 
ENTRY - 



1. 
2. 



3. 



Save AC 

Save location 

(including P.C. 

LINK and Memory 

Protect) 

Turn I/O ON 



- via 

JMS* API Device Address 
(i.e., JMS* (INT) 



1, 
2. 



3. 



Save AC 

Retain at INT the 
P. C, LINK and 
Memory Protect 
If first time 
through, NOP all 
PI commands 



Process I/O 




I/O 
com- 
plete^ 

N 



Continue 



Test for other errors; in- 




Reset 
(e_.g. , clear I/O 
Busy Switch 



Restore PI if PI interrupt 
and Debreak and Restore 



Return via 

stored 
^ P. C. 



PI and API Entries to Device Handlers 
Figure 7-2 
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exit sequence in order to ensure that the exit takes place before the 
interrupt from the issued lOT occurs. 

The CAL instruction must not be used at any level (API or PIC) that 
might interrupt a CAL. A CAL at such a level will destroy the content 
of location 00020 for the previous CAL. 



Care must also be taken when executing CALs at level 4. For example, 
a routine that is CALed from level 4 must know that if a debreak (DBR 
or DBK) is issued, control will return to the calling program (which 
had been at level 4) at a level lower than level 4. 

7.1.1 Setting Up the Skip Chain and API (Hardware) Channel Registers 

When the Monitor is loaded, the Program Interrupt (PI) Skip chain and 
the Automatic Priority Interrupt (API) channels are set up to handle 
the TTY keyboard and printer and clock interrupts only. The Skip 
chain contains the other skip lOT instructions, but indirect jumps to 
an error routine result if a skip occurs, as follows: 

SKPDTA /Skip if DECtape flag. 

SKP 

JMP* INTl /INTl contains error address. 

SKP LPT /Skip if line printer flag. 

SKP 

JMP* INT2 /INT2 contains error address. 

SKPTTI /Skip if teleprinter flag. 

SKP 

JMP TELINT /To teleprinter interrupt handler 



All unused API channels, memory protect, memory parity, and powerfail, 
also contain JMP's to the error address. 

When a device handler is called for the first time in a core load, it 
must call a Monitor routine (.SETUP) to set up its skip(s) in the Skip 
Chain, or its API channel, prior to performing any I/O functions. 
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The calling sequence is as follows: 

CAL N /N = API channel register 40 through 77 (see User's 

Handbook Vol. 1 ^ for standard channel assign- 
ments) , 
/O if device not connected to API. 
16 /.SETUP function code. 

SKP lOT /Skip lOT for this device. 

DEVINT /Address of interrupt handler, 

(normal return) 

7.1.2 Handling the Interrupt 

DEVINT exists in the device handler in the following format to allow 

fo3: either API or PI interrupts. 



ONLYl 



DEVPIC 



DEVINT 



IGNRPI 



COMMON 
DEVION 



LAC 

DAC 

DAC 

DAC 

JMP 

DAC 

LAC* 

DAC 

JMP 
JMP 
DAC 
LAC 
DAC 
JMP 



DEVCF 
ION 



(NOP 
DEVION 
DEVI OF 
IGNRPI 
COMMON 
DEVAC 

(]? 
DEVOUT 

COMMON 

DEVPIC 

DEVAC 

DEVINT 

DEVOUT 

ONLYl 



/LEAVE PI ALONE, WHEN API IS RUNNING 

/THESE REGISTERS 

/ARE AVAILABLE 

/THIS IS ONCE ONLY CODE 

/SAVE AC 

/SAVE PC, LINK, ADDRESSING MODE AND 
/MEMORY PROTECT 

/PI ENTRY 

/API ENTRY; SAVE AC 

/SAVE PC, LINK, ADDRESSING MODE AND 

/API IS OPERATING, SO LEAVE PI ALONE. 

/PI INTERRUPTS ARE NOT POSSIBLE, BE- 

/CAUSE .SETUP EFFECTIVELY NOP ' S PI 

/SKIPS. 

/CLEAR DEVICE DONE FLAG. 

/PI ALLOWS INTERRUPTS; API DOES A NOP 



DEVIOF 



I OF 
DEVIOT 



/API DOES NOP; PI TURNS 10 OFF TO ENSURE 
/NON-REENTRANCE AFTER ISSUING lOT ' S . 



/DISMISS ROUTINE 



DVSWCH 



LAC 
ION 
DBR 
JMP* 



DEVAC 



DEVOUT 



/RESTORE AC. 

/ION OR NOP . 

/DEBREAK AND RESTORE CONDITIONS 

/OF LINK, ADDRESSING MODE AND MEMORY 

/PROTECT. 



If the Index, Autoincrement, or EAE registers are used by the I/O de- 
vice handler, it is necessary to save and restore them. 
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.SETUP allows either API or PI, but not both for a single device. The 
System Generator Manual gives the method for incorporating neiw handlers 
and associated Skip Chain entries into the Monitor. 

7.2 API SOFTWARE LEVEL HANDLERS, An Introduction 

The information presented in the following paragraphs assumes that the 
reader is familiar with the system input/output considerations described 
in the PDP-15 User's Handbook Vol. 1. 

7.2.1 Setting Up API Software Level Channel Registers 

When the Monitor is loaded, the API software-level channel registers 
(40 through 43) are initialized to 



JMS* 


.SCOM+12 


/LEVEL 


4 


JMS* 


.SCOM+13 


/LEVEL 


5 


JMS* 


.SCOM+14 


/LEVEL 


6 


JMS* 


.SCOM+15 


/LEVEL 


7 



where .3COM is equal to absolute location 000100 and .SCOM+12 through 
.SCOM+15 (000112 through 000115) each contains the address of an error 
routine . 

Therefore, prior to requesting any interrupt at these software priority 
levels, the user must modify the contents of the .SCOM registers so 
that they point to the entry point of the user's software level handlers 

Example: 

.SCOM=100 

LAC (LV5INT / set level 5 entry. 
DAC* (.SCOM+13 



LV5INT exists in the user's area in the following format: 

LV5INT /PC, LINK, BANK/PAGE MODE, MEM. PROT . 

DAC SAV4AC /SAVE AC 
/SAVE INDEX, AUTOINCREMENT AND EAE REGISTERS, IF LEVEL 5 
/ROUTINES USE THEM AND LOWER LEVEL ROUTINES ALSO USE THEM. 
/SAVE MQ AND STEP COUNTER, IF SYSTEM HAS EAE AND IT IS USED 
/AT DIFFERENT LEVELS. 

/RESTORE SAVED REGISTERS. 

DBR /DEBREAK FROM LEVEL 5 AND RESTORE 

JMP* LV5INT /L, BANK/PAGE MODE, MEM. PROT. 

7-6 



7.2.2 Queueing 

High priority/high data rate/short access routines cannot perform com- 
plex calculations based on unusual conditions without holding off 
further data input. To perform the calculations, the high priority 
program segment must initiate a lower priority (interruptable) segment 
to perform the calculations. Since many data handling routines would 
generally be requesting calculations, there will exist a queue of cal- 
culation jobs waiting to run at the software level. Each data handling 
routine must add its job request to the appropriate queue (taking care 
to raise the API priority level as high as the highest level that 
manipulates the queue before adding the request) and issue an interrupt 
request (ISA) at the corresponding software priority level. The general 
flow chart. Figure 7-4, depicts the structure of a software handler 
involved with queued requests. 

Care must be taken about which routines are called when a software 
level request is honored; that is, if a called routine is "open" 
(started but not completed) at a lower level, it must be reentrant, or 
errors will results. 



NOTE 

The DOS hardware I/O device handlers do not 
contain reentrant procedures and must not be re- 
entered from higher levels. 

Resident handlers for Power Fail, Memory Parity, 
nonexistent memory violation, and Memory Protect 
violation have been incorporated into the system 
and effect an lOPS error message if the condition 
is detected. The user can, via a .SETUP, tie his 
own handler to these skip lOT or API channel regis- 
ters. 
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LV5INT 

SAVE PC, LINK, AC, 
AUTO-INDEX REGS, 
MQ.STEP COUNTER 
AND CONDITIONS 
OF EXTENDED MODE 
AND MEMORY PROTECT 




y 


NO 

r 


RAISE TO HIGHEST 
LEVEL THAT 
MANIPULATES 
LEVEL 5 QUEUE 







REMOVE ENTRY 
FROM QUEUE 



DBK BACK TO 
LEVEL 5 



GO HONOR THIS> 
JOB REQUEST 
VIA A JMS 



15-0094 



Figure 7-4 
Structure of API Software Level Handler 
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7.3 WRITING SPECIAL I/O DEVICE HANDLERS 

This section contains information prepared specifically to aid those 
users who plan to write their own special I/O device handlers for DOS. 

DOS is designed to enable users to incorporate their own device hand- 
lers. Precautions should be taken when writing the handler however, 
to ensure compatibility with the Monitor. 

Here is a summary of handler operation. The handler is entered via a 
JMP* from the Monitor as a result of a CAL instruction. The contents 
of the AC contain the address of the CAL in bits 3 through 17. Bit 
contains the Link, bit 1 contains the Bank/Page Mode status, and bit 2 
contains the Memory Protect status. The previous contents of the AC 
and Link are lost. 

In order to show the steps required in writing an I/O device handler, 
a complete handler (Example B) was developed with the aid of a skeleton 
handler (Example A). In addition. Appendices A and B are complete 
flowcharts of the OTA and DKA handlers. The skeleton handler 
is a non-reentrant type (discussed briefly at the beginning of this 
chapter) and uses the Debreak and Restore Instruction (DBR) to leave 
the handler at software priority level 4 or at a hardware level for 
interrupt servicing (if API), and restore the status of the Link, 
Bank/Page Mode, and Memory Protect. Example A is referenced by part 
numbers to illustrate the development of Example B, a finished Analog- 
to-Digital Converter (ADC) I/O Handler. The ADC handler shown in 
Example B was written for the Type AF^IB Analog to Digital Converter. 
This handler is used to read data from the ADC and store it in the 
user's I/O buffer. 

The reader, while looking at the skeleton of a specialized handler 
as shown in Example A, should make the following decisions about his 
own handler. (The decisions made in this case are in reference to 
developing the ADC handler) : 

a. Services that are required of the handler (flags, 
receiving or sending of data, etc.) - By lo ok i ng 
at the ADC lOT's shown in the Reference Manual, it 
can be seen that there are three lOT instructions 
to be implemented. These instructions are: Skip 
if Converter Flag Set, Select and Convert, and Read 
Converter Buffer. 
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The only service the ADC handler performs is that of 
receiving data and storing it in user specified areas. 
This handler will have a standard 256-word buffer. 

b. Data Modes used (for example, lOPS ASCII, etc.) - 
Since there is only one format of input from the 
Type AFOIB ADC, mode specification is unnecessary in 
Example C. 

c. Which I/O macros are needed for the handler's specific 
use; that is, . INIT , .CLOSE, .READ, etc. For an ADC, 
the user would be concerned with four of the macros. 

(1) .INIT would be used to set up the associ- 
ated API channel register or the interrupt 
skip lOT sequence in the Program Interrupt 
Skip Chain. This is done by a CAL (N) as 
shown in Part III of Example A, where (N) 
is the channel address. 



(2) .READ is used to transfer data from the ADC. 
When the .READ macro is issued, the ADC 
handler will initiate reading of the speci- 
fied number of data words and then return 
control to the user. The analog input data 
received is in its raw form. It is up to 
the programmer to convert the data to a 
usable format. 

(3) .WAIT detects the availability of the user's 
buffer area and ensures that the I/O trans- 
fer is completed. It would be used to ensure 
a complete transfer before processing the re- 
quested data. 

(4) .WAITR detects the availability of the user's 
buffer area as in (3) above. If the buffer 
is not available, control is returned to a 
user specified address, which allows other 
processing to continue. 

d. Implementation of the API or PIC interrupt service routine 
Example A shows an API or PIC interrupt service routine 
that handles interrupts, processes the data and initi- 
ates new data requests to fully satisfy the .READ macro 
request. Note that the routines in Example A will oper- 
ate with or without API. Example B uses the routines 
exactly as they are shown in Example A. 

During the actual writing of Example B, consideration was 
given to the implementation of the I/O macros in the new 
handler in one of the following ways : 

(1) Execute the function in a manner appropriate 

to the given device as discussed in(c). .INIT, 
.READ, .WAIT, and .WAITR were implemented into 
the ADC handler (Example B) under the subroutine 
names ADINIT, AD RE AD, AD WAIT (.WAIT and .WAITR). 

Wait for completion of previous I/O. (Example B 
shows the setting of the ADUND switch in the AD READ 
subroutine to indicate I/O underway.) 

7-10 



(2) Ignore the function if meaningless to the device. 
See Example B (.FSTAT results in JMP ADIGN2) in 
the dispatch table DSPCH. For ignored macros, 
the return address must be incremented in some 
cases , depending upon the number of arguments 
following the CAL (see Chapter 3) . 

(3) Issue an error message in the case where it is 
not possible to perform the I/O function - (An 
example would be trying to execute a .ENTER on 
the paper tape reader. ) In Example B, the handler 
jumps to DVERR6 which returns to the Monitor with 
a standard error code in the AC. 

After the handler has been written and assembled, the Monitor must then 
be modified to recognize the new handler. This is accomplished by the 
use of the System Generator Program (DOSGEN) described in the DEC- 
15-YWZB-DN12 manual. 

Wien the system generation is complete, the PIP program (refer to 
DEC-15-YWZA-DN13) must be used to add the new handler to the lOS UFD. 
At this time, the user is ready to use his specialized device handler 
in the DOS-15 system. 

7.3.1 Discussion of Example A by Parts 

Part 1 Stores CAL pointer and argument pointer, and 
picks up function code from argument string. 

Part 2 By getting proper function code in Part 1 and 
adding a JMP DSPCH, the CAL function is dis- 
patched to the proper routine. 

Part 3 This is the .SETUP CAL used to set up the PI 
skip chain or the API channel register. 

Part 4 Shows the API and PI handlers. It is suggested 
these be used as shown. 

Part 5 This area reserved for processing interrupt and 
performing any additional I/O. 

Part 6 Interrupt dismiss routine. 

Part 7 Increments argument pointer in bypassing argu- 
ments of ignored macro CAL's. 
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7.3.2 Example A, Skeleton I/O Device Handler 



/CAL ENTRY ROUTIME 




.5L0BL 


DEV, 


,ME0"3 






DEV, 


OAC 


DVCALP 




OAC 


DVARGP 




iS2 


DVARGP 




UAC» 


DVARGP 




AND 


(77777 




i$i 


DVARGP 




TAO 


(JMP OSPCH 




OAC 


dspch 


DSPCM 


XX 






JM^ 


OVINIT 




JMP 


OVrSAT 




JMP 


DVSEEK 




JMP 


DVENTR 




JMP 


DVCLER 




JMP 


DVCLOS 




JMP 


DVMTAP 




jMP 


DVREAD 




JMP 


DVWRTE 




JMP 


DVWAIT 




JMP 


DVTRAN 



/MUST BE or rORM AAA, 

/,MEO (MONITOR ERROR DIAGNOSTIC) 

/SAVE CAU pointer 

/AND ARGUMENT POINTER 

/POINTS TO ^UNCTION CODE 

/GET CODE 

/REMOVE UNIT NO If APPLICABLE 

/POINTS TO CAt*2 



lOlETE, (RENAM 



/DISPATCH WITH 


/MODiriED JUMP 


/I » 


• INIT 


/2 « 


.rSTAT» , 


/3 « 


.SEEK 


/A z 


.ENTER 


/5 . 


.Clear 


/6 « 


.Close 


/7 X 


.MTAPE 


/10 ■ 


(READ 


/ll = 


•WRITE 


/12 a 


.WAIT 



/13 



TRAN 



/ILLEGAL FUNCTIONS IN ABOVE TABLE CODED ASl 
/ jMP DVERR6 



/FUNCTION CODE ERROR 
DVERRd LAW 6 

JMP# (.MED*l 

/DATA MOOE ERROR 
DVERR7 LAW 7 

JMP» (,MED*1 

/DEVICE MOT READY 
DVERR4 LAC (RETURN 



DAC* (,MED 

LAC (4 

JMP* (.MEO*l 

/I/O UNDERWAY LOOP 
nVSUSY OBR 

JMP» DVCALP' 

/NORMAL RETURN FROM CAL 
nVCK oBR 

JMP» DVARGP 



/ERROR CODE 6 
/TO MONITOR 



/ERROR CODE 7 
/TO MONITOR 



/RETURN (ADDRESS IN HANDLER) 
/TO RETURN To WHEN NOT REaOY 
/CONDITION HAS BEEN REMOVED 



/ERROR CODE 4 
/TO MONITOR 



/BREAK FROM lEVEl 4 
/LOOP 0\ CAL 



/BREAK FROM lEVLF 4 
/RETURN AFTER CAl AND 
/ARGUMENT StRI^JG 



/THE DVIMIT ROUT'INE MUST INCLUDE 
/A .SETUP CALLING SEQUENCE FoR 
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/EACH FLAG CnMMECTED TO API 
/AND/OR Pi A(AT SGEN TIME), 

/THE SETUP Calling sequence iSi 



DVINIT CAL 



N 



16 

SKPIoT 
DBVImT 



/N 5 API CHANNEL REGISTER 

/(40 ^77), N 8 IF NOT CONNECTED 

/TO API 

/lOPS Function coDE 

/SKIP lOT TO TEST THE FLAG 
/ADDRESS 0^ INTERRUPT 
/HANDLER (PI OR API) 



/THIS SPACE MAY BE USED FOR I/O SUBROUTINES 

/INTERRUPT Handler for api or pi 



ONLYl 


lac 


(NOP 




DAC 


DEVION 




OAC 


deviof 




DAC 


DVSWCH 




DAC 


IGNRPI 




JMP 


COMMON 


DVPIC 


DAC 


DEVAC 




LAC* 


(3 




DAC 


DVOUT 




jMP 


COMMON 


nViNT 


JMP 


DEVPIC 




DAC 


DEVAC 




LAC 


DEVINT 




OAC 


DEVOUT 


IGNRPI 


jMP 


ONLYl 


COMMON 


devcf 




HEVION 


ION 





/SAVE AC 

/SAVElPCi UnK, rank/page MODE 

/AND MEMORY PROTECT 

/PI ENTRY 

/API ENTRYI SAVE AC 

/SAVEI PCi UINK, BANK/PAGE MODE 

/MEMORY PROTECT 

/LEAVE PI ALONE 

/ENABLE PI OR NOP 

/ENABLE PI OR NOP 

/THIS AI THE AREA DEVOTED TO PROCESSING INTERRUPT AND 
/PERFORMING AMY ADDITIONAL I/O DESIRED, 



DEVIOF 



lOF 
DEVIOT 



/DISABLE PI OR NnP 
/DIMISSAL BEFORE INTERRUPT 
/FROM THIS lOT OCCURS 



/INTERRUPT HANDLER DISMISS RqUTE 



nvoiSM 

DVSWCH 



LAC 

ION 

DBR 
JMP» 



DEVAC 



DEVOUT 



/RESTORE AC 

/ION OR NOP 

/DEBREAK AND RESTORE 

/LINK, SANK/PACE MODCi MEMORY 

/PROTECT 



/IF THE HANDLER USES THE AUTo I NCREMENT , 

/OR EAE REGISTERS, THEIR CONTENTS 

/SHOULD BE SAVED AND RESTOREDi FUNCTIONS 

/POSSIBLY IGNORED SHOULD CONTAIN 

/PROPER INDEXING TO BYPASS 

/CAL ARGUMENT STRING 

/ 

/CODE TO BYPASS IGNORED FUNCTIONS 

/ 



INDEX 



DVIGN2 



ISZ 

jMP 



DVARGP 
DVCK 



/BYPASS FiLt POINTER 
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CHAPTER 8 



BOSS-15 



BOSS enables DOS users with a card reader and a line printer to run 
jobs sequentially, with a minimum of operator intervention. BOSS sup- 
ports a subset of the DOS system programs, and adds a line editor, its 
own resident and nonresident routines (called Resident BOSS and Non- 
resident BOSS), and the Procedure Files. Paragraph 8.1 describes Pro- 
cedure Files. Figure 8-1 shows which monitor supports each system 
program. 

The DOS programs run by BOSS are identical to those run by DOS. Ex- 
ceptions are the Resident and Nonresident Monitors, which are ex- 
plained later. BOSS expands the information on Control Cards into 
a series of commands in the format expected by the DOS system pro- 
grams. Nonresident BOSS does this command expansion, and stores the 
expanded commands in a disk file, the Run Time File (RTF). Since DOS 
programs expect to communicate with an operator at a teleprinter, BOSS 
feeds the expanded commands to the programs via .DAT slots assigned 
to TTA. In BOSS mode, therefore, BOSS attaches .DAT-2 to the Run Time 
File, and directs most teleprinter output to the Line Printer. Pro- 
grams can force I/O to the teleprinter by setting bit 4 in .SCOM+52, 
and preceding with macros directed to TTA. 

Whenever bit of .SCOM+52 is set, the System Loader Interface attaches 
the Resident BOSS code to the Resident Monitor. The main purposes 
of Resident BOSS are to (1) ensure that BOSS will retain control of 
the teleprinter, (2) feed commands to programs via the Run Time File, 
(3) properly route internal Monitor commands, such as .EXIT, .GET and 
.PUT, and (4) direct teleprinter output to the Line Printer. Figure 
8-2 illustrates the connections between the DOS Resident Monitor and 
the BOSS Resident Monitor that accomplish these changes. Figure 8-3, 
the flowchart for Resident BOSS, further describes Resident BOSS. 

Resident BOSS communicates with Nonresident BOSS by TRANing informa- 
tion to and from the first block of Nonresident BOSS. Nonresident 
BOSS gains control on all error conditions, such as lOPS, operator 
abort, Time Estimate exceeded, and after a B0SS15 command. Figure 8-4 
is a flowchart of Nonresident BOSS. 
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RESIDENT B0SS1S INTERFACE TO RESIDENT MONITOR 
AND USER PROGRAM OR SYSTEM PROGRAM 

PROGRAM CONTROL 

INFORMATION FLOW 



■IF QDUMP WAS SPECIFIED THEN THE DUMP 
WILL TAKE PLACE BEFORE GOING TO 
RESIDENT B0SS15 



NOTE: SEE RESIDENT BOSS FLOW CHARTS 
FOR DETAILS. 



©-- 




RESIDENT B0SS15 



BACK TO USER AFTER 
READ .WAIT TO -7 OR 
IF USER "CAL" WAS * 
NOT A. RE AD 



INFO TO & FROM DISK 

t 
I 



I * 






BOOTSTRAP 



L. 



-h- 



Gk 



USER WANTS TTV 



BACK TO USER 
AFTER .WRITE ■" 
.WAIT OR IF NOT 
A. WRITE CAL 
AND USER DOES 
NOT WANT TTV 



n 



SWITCH USER 
READTO 2T0 7 

1 



CHECK FOR IOPS4 
OR to WANTED" 



TRANSFER ERROR 
DATA TO IstBLKOF 
NR B0SS15 



TRANSFER CARD 
DATA TO 1st BLOCK 
OF NR BOSS 
.EXIT 
1 



SWITCH USER WRITE 
TO 3 TO 6 UNLESS 
TTY IS SPEC. BIT 4 OF 
.SCOM + 52 SET 




-I-. 



\- 



lOPS ERROR FROM 
I/O HANDLER OR USER 



I OPS 4 
RETURN 



I re: 



RESIDENT MONITOR 
DAT UFDT 



^ 



3Hf- 



I- 



EXPANDED 

ERROR 
PROCESSOR 



EXIT 
PROCESSING 



NORMAL 

I OPS 

ERROR 

PROCESSOR 



DUMP 
CORE 



INPUT 
FROM TTY 



OUTPUT 
TO TTY 



TELETYPE 
HANDLER 



-Q 



"CAL" ENTRY 
TO TTY 
HANDLER 



B0SS15 
' CONTROL 
I CARD 



BACK FROM 
DATX 



DATX 
A 



CARD READER 
HANDLER 



NORMAL 

CARD 

DATA 



.READ .WRITE 

X 3 

OR ANY DAT ASSIGN TO TTY 

"USER OR SYSTEM PROGRAM 



•NOT NON RES B0SS15 



Figure 8-2 
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lOPS Error 
Routine : 
EXITLT 



Expanded 

lOPS Error 

Routine 

BOSS0 



Control Q 

Processing, 

via .SCOM+72 




lOPS.E (JMS Entry) 



RETURN 



Set Expanded Error 
flag for Nonresident 
BOSS 



Store error data in 
Resident BOSS .ERR, 
,MED, and in the ad- 
dress pointed to by 
.SCOM+37 



<^ wanted^ ^ i 



Go to CTRL 
Q Routine: 
MANSAV 



> 



N 



Monitor TRAN in the first block of 
Nonresident BOSS, starting at 
C{.SC0M+2) 



JJd 



Starting at C(.SC0M+2) + 44g, trans- 
fer lOPS error data to core image of 
block 



Set bit 5 of .SCOM+52 



Monitor TRAN block out 
to first block of Non- 
resident BOSS 




Points within the Resident Monitor which transfer control to Resident BOSS - 15 

RESIDENT BOSS - 15 

Figure 8-3 
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DAT3.B 



j(,DAT-3 or any .DAT slot 
/assigned to TTA, ) 




Compose a .WRITE 
to .DAT+6, using 
caller's data 
mode 



1, Clear bit 4 or 
.SCOM+52 

2. Make sure tele- 
printer is not 
busy 




Using caller's buffer address and 
word count, compose a .READ to 
.DAT-7, the run time file (RTF) 
on the system device 



^ 



Issue .READ to .DAT-7, and await 
completion 




Transfer to 
^ TTA. , 



Move user's buffer (minus the 
header word pair) to Resident 
BOSS (always 42g words) 



issue .WRITE to .DAT+6 (the 
Line Printer) and wait for 
completion 




Increment the 
line count 



jkki 



SiBt bit 2 of 
.SCOM4-52 



.±. 



Return to 
use after 
CAL 



) 




Processing for I/O Macros addressed to .DAT slots -2 or -3, or any slot assigned to TTA. 



Points within the Resident Monitor which transfer control to Resident BOSS - 15 

RESIDENT BOSS - 15 

Figure 8-3 (cent.) 
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.EXIT 

Processing 

EXITA 



TIME OUT 

Processing 

TIMGON 



Operator 
Abort +T 
TTDDTR 



.PUT and .GET 

Processing 

B0SS2 



Set bit 3 in .SCOM+52 



Set bit 7 in .SCOM+52 




B.EXIT 



Set bit 17 in .SCOM+52 



Set up .SCOM+43 & 44 to 
bring in the Nonresident 
Monitor 



B.EXT0 




Monitor TRAN first block of Nonresident BOSS 
starting at C(.SC0M+2), 



Jd. 



Move card image from CD's handler's butter to 
block image, and TRAN the block back to Non- 
resident BOSS 



Issue .INIT's to every entry in the Mass 
Storage Busy Table 



Zero the number of Busy Table entries 



Return to 
.EXIT pro- 
cessor at 
EXITA + 1 



Set bit 10 in 
.SCOM+52 



\k 

Change CTRL Q 

entry point via 
.SCOM+72 



Go to CTRL 
Routine at 
JMANSAV 



Points within the Resident Monitor which transfer control to Resident BOSS - 15 

RESIDENT BOSS - 15 
Figure 8-3 (cont.) 
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start Address 420 



Execute bank bit initialization code 



Save value of TIME OUT clock, and disable it j 



Disz±)le CTRL C and set up CTRL T address; save contents 
of .SCOM+42, set MICLOG bit and clear user bit 



Set .UFDT -15 and -14 to "CTP" and delete all files in 
the CTP UFD named PRCFIL PRC 



I Perform .ENTER on .DAT-15 for PRCFIL PRC; set line count = 



Save current logged- in UIC in D.12 ; force 
"CTP" to be logged-in UIC 



Save system device code m D.ll 




Set bit 17 in Job Status Word AC.STA 




Set bit 2 in Job status word 
Print, "END OF RUN TIME FILE 
REACHED BY USER" on the LP 



F^ 



Set bit zero of .SCOM+52 





Next Page 



Nonresident BOSS 
Figure 8-4 
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From Preceding Page 



Neither 



Set bit 3 in Job Status Word 



Print on Line Printer, "TIME 
ESTIMATE EXCEEDED" 





.PUT 



.GET 



Set bit 11 in Job 
Status word 



Print on Line Printer, 
"USER DID A .PUT" 



Print on Line Printer, 
"ILLEGAL .GET BY USER" 



Set bit 10 in job 
Status Word 




M-. 



Set bit 5 in Job 
Status Word 



Print on Line Printer, 
"TERMINAL ERROR 




GDUMP 



Set bit 6 in Job Status Word} 



Print on Line Printer, 
"LOAD ERROR " 



Set bit 16 in JOB 
Status Word 





^ Set bit 7 in Job Status Word 
Print on LP, "OPERATOR ABORT" 




Nonresident BOSS 
Figure 8-4 (cent, 
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PIP CARD RETURN 



Normal CONTROL 
CARD Return 





{Close out PIP command processing] 




Nonresident BOSS 

Figure 8-4 (cent.) 
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Write line in "RTF" 





write "PIP" line into "RTF" 



I 



[count line and "set PIP switcTil 



Set up to get character from card: 
Skip over "$" and pack character in 
CARDP 



PTPr , 1 



Get a character 




Jk 



Pack the character | 




Pack a Carriage RETURN 



Nonresident BOSS 
Figure 8-4 (cont.) 
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I Clear Job Status Worcj | 




Make sure the Time Out 
Clock will be disabled 
upon exit from NR BOSS 



Set bit 8 in ,SCOM+52 
(Job Active Flag) 



Store JOB I.D. into account in- 
foinnation buffer 



Get a character 




Pack character into 
account buffer 




> 



Pad with nulls until nine 
characters have been packed 



Enter date and start time 
into account information 
buffer 



Start elapsed time clock, by 
depositing zero into .SCOM+34 



Print Job Start Message on LP| 
/ SUBSTT \ 




Nonresident BOSS 
Figure 8-4 (cont.) 
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(Create an ADD File) 



Set CRT Flag 



Set up to pack into CARDP 




Use default file name "TMP" jpack file name and extension, if any 




Use default extension 



"ADD" I 



I Perform .USER to .UFOT-11^ with user's Uic"") 




Perform .ENTER to .DAT-11 for filej 



SC 



[Read the next card| 



CR.ERR 



Print on LP, "ILLEGAL 
COMMAND FOR ADD FILE" 



Set bits 4 & 17 in 
Job Status Word 



.CLOSE .DAT-11 





I Write card into ADD File 



vvA 



(CR.CRn 




.CLOSE .DAT-11 
Clear CRT flag 




Nonresident BOSS 
Figure 8-4 (cont.) 
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Set bit zero of ADDSTA 
Set bit one of .SCOM+56 



Zero directory entry block 



Set up to pack into ADDFIL 




Use default file name "TMP" 

: 



I Use default extension "ADD"| 






jZero bits 2-17 of .SCOM+52] I Clear Job "Active Flaq| 




[Reopen Job Procedure file] 




Enter finish and 
elapsed time into 
Account Informa- 
tion buffer, and 
.CLOSE .DAT-14 




Inhibit Card Reader 
(Set bit 1 of .SCOM+52 



'M. 



Set End Job Flag 
(bit zero of Job Status 
word ) 



Convert elapsed 
time to hhmmss 




Next Page 
Nonresident BOSS 
Figure 8-4 (cent.) 



!-13 




From Preceding Page 



Perform .ENTER to .DAT-14 
(ACCNTG 001) ; Set up the 
buffer with 176002, X, -1 



Write out a ten-block 
file, and close .DAT-14 



Reset File Entry Count to zero] 




Increment alternate file 
extension (002, 003,.. 777) 



Calculate buffer position 
within block from entry 
count 



Move entry into proper 
block image, via .RTRAN 




Update entry count by 1 




Tell operator 
on console TTY 



Rename account file 
to new alternate 
name and extension 



Print End Job Message 
and second line, con- 
taining ID, Date, S. 
time, F. Time and run 
time 




CRAFID 





Set bit 9 in .SCOM 
+52 (Exit Boss flag) 



Close out PIP com- 
mand processing 




Close out PIP com- 
mand processing 



Write and count "LOGOUT" line to "RTF" 



Nonresident BOSS 
Figure 8-4 (cent.) 
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Issue .INIT to "RTF"; 
zero all BOSS reg- 
isters and bits 



Make "SCR" the login UIC 





Restore .SCOM+42 with 
user mode bit (bit 17) 
set; restore user's 
UIC 



Write out BOSS line in 
"RTF" (BOSS-15) and 
count it 



Store line count in bits 
0-8 of .SCOM+75 




Close "RTF" and ADD files 



TRAN out first 400q words 
of Nonresident BOSS 



Clear various bits in 
.SCOM+52 



.EXIT 
(To NRM) 



jik. 



Write out "DUMP" line to "RTF" 



Disable the Time Out Clock, so 
the user gets a complete dump; 
count two lines 



Write out "ALL" to "RTF" and 
ent with an ALT MODE 




Print on LP, "RUN TIME 
FILE TOO LONG" 




Close ADD file, .INIT "RTF" 
and .ENTER a new "RTF" 



Indicate "RTF" is empty 




Nonresident BOSS 



Figure 8-4 (cent.) 
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8.1 PROCEDURE FILES 

To each BOSS command there corresponds a disk-resident ASCII file, 
called a Procedure File. The Procedure File contains DOS commands. 
When DOS executes the commands in the Procedure File, it carries out 
the function specified by the BOSS control card. The DOS commands 
in the Procedure Files contain fields (for instance, a file name) 
that Nonresident BOSS fills in with text strings from the control 
card. These fields are called, "Variable Fields". Before executing 
the DOS commands contained in the Procedure File, therefore, all the 
variable fields have to be resolved. This process is very similar to 
a macro expansion, where (1) DOS is the assembly language, (2) the 
BOSS command name is the macro name, (3) the contents of the BOSS 
control card are the macro arguments, and (4) the Procedure File is 
the macro definition. The expanded DOS commands are put in a Disk 
File, called the "Run Time File (RTF)". The RTF can contain the ex- 
pansion of one or more Procedure Files, up to 777- lOPS ASCII records. 

o 

BOSS expands Procedure Files strictly on a text string, character 
basis. It has no knowledge of the intrinsic function of each BOSS 
control card, except for $ JOB , $END, $CRT, and $ADD ($END, $CRT, $ADD 
have no Procedure Files) Appendix c contains a listing of all standard 
Procedure Files. 

8.1.1 Procedure File Format 

In order to ensure successful expansion, all Procedure Files must fol- 
low a strict format. The first record of the Procedure File must be 
a control record, with parameter information. The first record may 
also contain comments , because BOSS interprets only pertinent informa- 
tion, and ignores the rest. The numbers 0, 1, 2, 3, and 4 specify 
different options. All other characters are ignored. The option 
digits can appear in any order, and anywhere on the record. The op- 
tion specified by each number is given below: 

- Expanded Substitution (default, if "3" not given 
explicitly) 

This option specifies that the Procedure File is to be 
expanded according to the normal rules of substitution, 
which are given below. 
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1 - Open Ended File (default, if "2" not given 

explicitly) 

This option instructs the Nonresident BOSS Monitor 
to leave the RTF open after expanding the current 
Procedure File. BOSS then searches for the next 
control card. 

2 - Closed End File 

This option instructs Non-resident BOSS to close 
the RTF after expanding the current Procedure File, 
and to execute the DOS commands in the RTF. Pro- 
cedure Files corresponding to commands that may 
possibly be followed by "Data Cards" should be 
of Type 2. 

3 - Direct Substitution 

This option indicates the BOSS should not expand 
the Procedure File according to normal rules. 
Refer to paragraph 8.1.2 for information on 
Direct Substitution. 

4 - Test Mode 

This option indicates that BOSS should echo the 
Procedure File expansion on the Line Printer. 
This allows a check on the Procedure File. 

The following combinations are illegal: 

and 3 

1 and 2 

If BOSS finds an illegal option combination, it will print, 

ILLEGAL PROC FILE 

and search for the next control card. 

BOSS uses all other records in the Procedure File as macro definition 
records. Records after the first one are all Macro Definition Records, 
For each such record, a record will be written in the RTF. Each Macro 
Definition Record has the same format. Two types of fields are used: 
K-fields and V-fields. K-fields specify constant character strings 
that will be written into the RTF exactly as they appear in the Pro- 
cedure File. V-fields specify variable character strings to be sub- 
stituted from specified strings on the Control Cards. Each Macro 
Definition Line of a Procedure File can contain any number of K- and 
V-fields, in any combination. V-fields are delimited by @-signs. 
K-fields are delimited by adjacent V-fields, or the end or beginning 
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of the record. Since there are only two types of fields, only one 
need have delimiters. Two adjacent V-fields, however, require two 
adjacent @-signs. 

K-fields 

K-fields may be any string of legal lOPS ASCII characters, except the 
@-sign. 

V- fields 

A V- field has the following format*: 

^0n\ 



zMtirA^^^^ 



^ = - -,n f 
^ J 

The two (a-signs delimit the field. The first part of the field (A, 
D, U or O) is a card-position identifier, and must be present. It 
identifies the position on the current Control Card of the character 
string to be substituted in the RTF. The legal combinations are: 

Aj?J?,AJ3ri, A|?9 

U00,U|2fl, UJ?9 

Dj?0,Dj?l, D09,D10, . . .D17 



With the exception of D10 through D17, each of the above position 
identifiers corresponds to a unique character string of the Control 
Card, according to the following scheme: 

$CMD;0 Ai?j3f:D00(Ui?jaf) ; A01 : Dj2ri (Upfl) ; ; AJ3r9 :Dj?9 (UJ2f9 ) 

The Dl)3f...Dl7 position identifiers do not correspond to character 
strings found on the Control Card, but rather to character strings 
defined by BOSS. Thus, 

Dlj? - Unused 

Dll - .SIXBT representation of the System Device Code 

('DK'or 'DP') 
D12 - Current Logged in UIC 

D13 - .SIXBT representation of Carriage RETURN 
D14 - .SIXBT representation of ALT MODE 
D15 - Unused . 
Dl6 - Unused 
D17 - Unused 



* Standards for this format description are identical to those speci- 
fied in Chapter 5 of the DOS-15 User's Manual, DEC-15-MRDA-D. 
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The parentheses in a V- field mush be present. They are used to speci- 
fy a default string. The default string is used in case the string 
on the Control Card specified by the position identifier is null. A 
set of parentheses must be included, even if the default string is 
null. The default string itself can be a variable, resulting in nested 
variables. Nesting has a theoretical limit of 2"'"'^ variable fields. 

8.1.2 Direct Substitution 

When processing a Direct Substitution Procedure File, BOSS places the 
fields on the Control Card into the RTF just as they stand with only 
leading spaces ignored. That is, BOSS does not necessarily expect to 
find file names, and so on, as with normal substitution. Fields on 
the Control Cards are separated by semi-colons (;), and are processed 1 
in a serial manner. The ampersand (&) is used for a special purpose. 
It causes the current record being composed for the RTF to be termin- 
ated with a Carriage RETURN, and written out, and a new record started. 
This is so that the limit of seventy-five characters per line will not 
be exceeded. 

There are only two legal field types within the Procedure File. They 
are as follows : 

1. A00 through A9 9 

2. Dlj? through D17 (System Defined) 

In making up Direct Siibstitution Procedure Files, the following rules 
must be followed: 

1. The first line must contain a three (3). This declares 
the file to be direct substitution. 

2. The "A" fields must appear in sequential order, starting 
at A00. Each "A" field can be used only once within the 
Procedure File. 

3. The "D" fields can only be "D10" through "D17". They 
can be used any number of times, in any order. 

4. Variable expressions must follow the standard V- field 
format, as in expanded substitution. 

8.1.3 Example of Procedure File 

The following example shows a typical Direct Substitution Procedure 
File, the Control Cards used to call it, and the resulting lines 
produced in the Run Time File. 
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Procedure File - Map PRC 



3 PROCEDURE FILE TO RUN CHAIN WITH NO OVERLAYS 

CHAIN 

@A|3^0 (TMPXCT) @(aD14 ( ) @ 

@A01{SZ) @@D14() @ 

@Apf2 (FILTMP) @(aDl4 ( ) 9 

@D14()@ 



Control Cards as They Appear 



$MAP TESTl ; S Z , VTC/ABC , DEF , NAMl , &NAM2 , ; 
$ *01 NAM3 , NAM4 ,NAM5/ ; TESTl , SUBl , SUB2 , & ; 
$*02 SUBS, SUB4, SUBS 



Run Time File Lines 



CHAIN ) 

TESTl (ALT MODE) 
S Z , VTC/ABC , DEF , NAMl , ) 
NAM2,NAM3,NAM4,NAM5/ (ALT MODE) 
TESTl, SUBl, SUB2,") 
SUBS, SUB4, SUBS (ALT MODE) 
(ALT MODE) 



Note: Dl4=Altinode, <ALTMODE> is an Altmode, and <CR> is a 
Carriage Return. 

i 
8.2 BOSS-IS ACCOUNTING 

i 
BOSS has a very simple accounting mechanism. It keeps an account 

record for each job in a random access . file in the CTP UFD. Hence, 
the file is protected, and can only be accessed after successful ex- 
ecution of a $MIC command. 

The name of the accounting file is ACCNTG nnn. (The first has an ex- 
tension of 001.) Each file is ten physical blocks long, and contains 
enough information for SljZf jobs, thirty-one per physical block. When 
BOSS fills up one file, it increments the extension, and starts a new 
one. Every time a job ends, BOSS checks whether ACCNTG 001 exists. 
If it does not, BOSS creates one. If it does, BOSS checks whether 

it is full. If not full, BOSS makes a new entry; if full, BOSS 
^Direct Substitution File 
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searches for the first unused extension number. If all extension num- 
bers have been used (up to 999) BOSS prints this message to the opera- 
tor on the teleprinter: 

MAX NUMBER OF ACCOUNTING FILES REACHED 
PLEASE PROCESS AND DELETE THEM 

Every time the system manager processes an accounting file, therefore, 
he should delete the file. 

For each completed job, BOSS writes out an eight-word record to the 
accounting file. The records have the following format: 

Word # Content 

1^ ^Job I.D. , 
in 



3J Is^.SIXBT 

4 Date, packed mmddyy 

5 Start Time, in hhmmss 

6 End Time, in hhmmss 

7 Run Time, in hhmmss 

8 Terminal Job Status Word 



A word whose contents equal 777777 immediately follows the last job 

o 

accounting record in each physical block of the accounting file. 

8.3 B . PRE 

Figure 8-5 is a flowchart of B.PRE, the BOSS Line Editor. 
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START 



Initialize .DAT slots -14 and -15 



Zero FLAG 



Read updated file name and exten- 
sion from .DAT- 2 




Assume updated file name equals 
the original file name 



Read file name and extension 
from .DAT- 2 



CDREAD 



Read a card from .DAT +5 



EOF 




EDIT 



neither 



1. Set FLAG to 1 

2. Issue .ENTER to .DAT-14 



Write card image to .DAT-14 



Read a card image from .DAT+5 





^. CLOSE .DAT-14 




Perform .SEEK to .DAT-14, and 
.ENTER to .DAT-15 



Zero LI, L2, LNCNT 



Delete 



Subst. 



Print error 
message 



.EXIT 





Increment LNCNT 



Read a record from 
.DAT- 14 and write 
it into .DAT-15 



Read a record from 
.DAT-14 and write 
it into .DAT-15 



[Read a record from .DAT-14 



Increment LNCNT 




"TT 



Read from .DAT+5 




.CLOSE .DAT-14 &-15 



Write card image 
to .DAT-15 



.EXIT 



{ EDIT J 



b.pr£: 
Figure 8-5 (cont.) 
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(Entry from^\ 
CAL Handler ) 



1. Save pointer to CAL 

2. Save subf unction or data mode 



ERROR 
lOPS 17 




4- 



Swap descriptor 
blocks for .DAT 
slots A and B 







Swap descriptor 
blocks for .DAT 
slots A and C 




Get function code^ and make up 
dispatch instruction 





Request a buffer 



Next Page 
DECtape 'A' Handler ' (DTA. ) 



A-1 



From Preceding Page 



ERROR 
lOPS 55 




Set up word pointers within the new 
buffer — e.g., buffer+377 = link 





.INIT (Function Code #1) 



1. 


Give user standard buffer size (377) 


2. 


Set input or output file indicator 


3. 


Wait for previous I/O to finish for 




DEC tape 




1. Do .SETUP to API and Skip Chain 

2. Test buffer size. If not 440 
or greater, terminate with an 
lOPS 70 



8 



3: 



Return to 

user after 

CAL 



DECtape "A" Handler (DTA.) 



A-2 




(.OPER, Function Code #2) 



ERROR 
lOPS 6 



Dispatch to requested sub- 
function and process 



Exit to 
user after 
^ CAL 



(Loop back to user CAL) 




(.SEEK, Function Code #3) 



ERROR 
I OPS 10 



ERROR 
lOPS 7 



Bring directory into core, if not al- 
ready in 




ERROR 
lOPS 13 



1. Obtain starting block number 

2. Read the first file block into core 



/^ Return to >^ 
( user after } 

DECtape "A" Handler (DTA.) 



A-3 



g ), ENTER (Dispatch Code 4) 



(Loop back to user CAL. } <- 




ERROR 
lOPS 7 



Bring Directory into core, if not 
already in 




Set indicator so that file is deleted 
upon a .CLOSE to this .DAT slot 



Search directory bit map (in core) for first free block 




Was 
a block a-^^ ^ 
raileible. 



ERROR 
lOPS 15 



Set up to write out this block, when 
the time comes 



Exit to 
user after 

> CAL 



(Loop back to user CAL.) 




.CLEAR 

(Dispatch Code 5) 



ERROR 
lOPS 10 



1. Clear out file bit maps 

2. Clear directory block with the SYS 
block bits set in the directory map 



S 



"^Sxit to 
user after 
CAL 



DECtape "A" Handler (DTA.) 

A-4 



(Loop back to user CTU^) 



<r 



1. Clear bit in bit maps 

2. Clear switches 




.CLOSE 

(Dispatch Code 6) 



^ 



Clear switches 



1. Put End-of-File 
indicator in buffer 

2. Write out last block 
in file 




The following is done on 
the in-core bit maps: 

1. Zero its bits in the 
directory bit map 

2. Overwrite its file 
bit map with the 

new one 



<- 



Write out updated directory and file bit map 



Return the buffer to the 
system 



C Return to ^ 
user after J 
CAL y 

DECtape "A" Handler (DTA. ) 



A-5 



(Loop back to user's CAL) 



Pass 001005,776773 
sequence to user's 
buffer 




.READ 

(Dispatch Code 10) 



N 



1, Transfer line to user's 
buffer 

2. Set data validity bits 




Set EOF indicator 



Read in next block of file 



■> 



■^ 



Exit to 

user after 

CAL 



DECtape "A" Handler (DTA.) 
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Loop back to user's CAL^ 




.WRITE 

(Function code 11) 



Set "write executed" 
switch 




1. Write out block; 2. search for next block 



.^ 



Exit to 

user after 

CAL 





ERROR 
lOPS 15 



■> 



1, Transfer user buffer to handler 
buffer 

2. Compute Checkstim 




EOF 



N 



Transfer the block 



/^ Exit to \ 
[ user after J 




.WAIT & .WAITR 
(Function Code 12) 



Set .CAL pointer to specified address 




Exit via 
CAL Dointer 



DECtape "A" Handler (DTA. ) 
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Loc^ back to user CAL <- 




.TRAN 

(Function Code 13) 



1. Set up block to tremsfer in or out 

2. Set up core address-1 

3. Set up word count 

4. Start transfer 



Exit to 

user after 

CAL 



INTERRUPT SECTION 



Stop tape 




Entry from 
PI or API 



Save information 
to restore later 



Read status register "B" 





Set up Current Address & 
word count for read or 
write 



Set up current address 
and word count for 
search 




DECtape "A" Handler (DTA. ) 





A-( 






On 

sSearch^ 



ERROR 
lOPS 12 



Change 
direction 



Try 
again 




1. Accept data as is 

2. Get rest of data 




ERROR 
lOPS 12 




(ERROR Logic) 



±. 



2. 
3. 
4. 

5. 



Read Status Register "A" and 

save it 

Clear Status Register "A" 

Disable interrupts 

Set return in ,MED (register 3, 

bank J3) 

Clear I/O underway switch and 

enable CTRL P 



.MED 



Give lOPS 4 



1. Set I/O underway switch 

2. Set up Current Address and 
Word Count for search 



Start up DECtape 



<■ 



1. Restore PIC interrupt entry and AC 

2. Turn interrupt on, if this was a PIC 

3. Debreak and Restore 



CExit to ^ 
interrupted J 
code ^ 

DECtape "A" Handler (DTA.) 
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Branch to ^ 
user's CAL 



l^ Entry from A 
— — 3>l CAL Handler ) 



M. 



1. Save the pointer to the CAL 

2. Save the .DAT slot number and subf unction 
code (bits 5-8 of L0C+i3) 




Do .SETUP for PI and API interrupts 



Determine number of platters 





I0PS21 



Calculate the maximum block number, for- use 
at .CLEAR time 



■^ 



Calculate size of the TEMP list for pre-allocated 
blocks, and set the BUF.OK switch (SGEN size ok) 





WAIT 



— Fall through to "10. OFF' 
Next Page 
Disk "A" Handlers 



B-1 



From Preceding Page 



i 



1, Calculate pointers to the arguments of the CAL 

2. Save step counter and MQ for EAE 




(DISPCH) 




Next Page 
Disk "A" Handlers 



B-2 



From Preceding Page 





■M lOPS 70 



lOPS 55 



1. Save pointer to buffer, and zero entire buffer 
2« Complete the Busy TzJple entry 



1. Get UIC from the Busy Table entry 

2. Bring in the Current Set from buffer 

3. Set up pointers to: User's Directory Entry, tem- 
porary block list. Data Block Words 0,1,2,3,376 & 
377 



PISPCH 





Note: .TRAN, .WAIT and .WAITR 
have already been inter- 
cepted. 







1 
Disk "A" Handlers 
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1. wipe out entry in UFD, and 

2. Give back pre-allocated blocks 



1. 


Return any allocated buffer 


2. 


Zero any old busy table entry 


3. 


Make a new entry in the busy table 


4. 


Save Write Check bit in busy table 


5. 


Indicate "current" .DAT slot is 




zero 



Exit to 
LCX:+4 




Sub 
functions\ N 
1»2,3, 

Y 
Next' Page 
Disk "A" Handlers 
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From Preceding Pagie 



.DLETE 



1 



Search for file 



Found ^^>-** > 



lOPS 63 




AC=^ 



1, Delete the file 

2. Give back all 
blocks 



1« Return aquired 

buffer 
2. Make "current" 

.DAT slot zero 




lOPS 10 



1, Rename the file 

2, Insert current 
date 

3, Load AC with the 
first block num- 
ber 



lOPS 51, 
71 or 13 



Exit to 
LOC+3 




(.FSTAT) 



1, Place device type in LOC+2 of CAL 

2, Search for file 




Found 



Load AC with first 
block number 

1 



Zero the AC 



lOPS 



Exit to 
LCX:+3 



Disk "A*! Handlers 



.RAND 



Initialize RIB 
number to zero 




(Found) 



Place file size in 
LOC+3 

2, Read in first RIB 

3. Move RIB to top of 
buffer, if neces- 
sary 




Exit to 
EX I TAD 



B-5 



(.RTRAN) 




lOPS 11 



relative 

block number 

^ number of 

"file blocks' 



lOPS 66 



Calculate RIB block number, and the desired pointer's 
position within that RIB block 




Depending on the location of the desired block, rela- 
tive to the RIB block in core, read in the next or 
preceding RIB block 




Save pointer to desired data block 



RF 



■\or RP/" 



Store starting word number and the number 
of data words desired 



lOPS 67 




Assiune transfer starting at word zero, 
through word 375, and set parameters 
accordingly 



Set direction switch 




Input 




RET] 



Use word count given in CAL during disk 
pack input 




_^SETRE 



Disk "A" Handlers 
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Set up user's buffer to receive the link words for block 



N - no forward lin 




Set both link 
words to -1 



Current 
lib block contain" 
both link 
■ pointers. 





N - no backward 



link 



Set links in data block from adjac- 
ent pointers in the RIB block 



Set backward link to 
adjacent pointer in 
RIB, and forward link 
to -1 



Set backward link to 
adjacent pointer in 
RIB block 

2. Read in next RIB block 
and adjust RIB number 
indicator in the cur- 
rent set 

3. Set forward link to 
first pointer in the 
new RIB block 





1. Set forward link to 
adjacent pointer in 
RIB 

2. Read in previous RIB 
block and adjust RIB 
number indicator in 
the current set 

3. Set backward link to 
last pointer in the 
new RIB block 



Set forward link 
to adjacent poin- 
ter in RIB, emd 
backward link to 
-1 



Set up driver with the 
correct block number 



Set up driver with the 
correct word number 



I 



Bring in or send out 
required block or data 



Exit to 
LOC+5 



Disk "A" Handlers 
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lOPSlO 



FINDER 
Search MFD and UFD 
START = Pointer to 
SAT word 3 



(No entry in MFD 
for this UIC) 




1 

(Entry in MFD, but 
UFD is empty) 




(UFD exists, but does 
not contain a file by 
the given name) 




(UFD exists, and con- 
tains a file by the 
given name) 




1, Save number of the last MFD block read 

2, Save file name 



ENTSET 
Preallocate 
some blocks 



Read in last MFD block 



Set pointer to free slot 
found by FINDER 





GETNXT 

Get next 

block number 



Read it in 



H 



1. Make forward link of last MFD block 
point to the next block 

2. Write out the block 

T- PI par the buffer 



1, Set up entry pointers 

2, Insert new UIC, entry size and zero protection 
code (unprotected) into new MFD entry 




(MFDSI 
Disk "a"" Handlers 



♦That is, has a .RAND, .SEEK or 
.ENTER been issued without a 
.CLOSE? 



B-9 




CKDIRP 
Is directory 
protected? 



IOPS63 



N 



ENTSET 
Preallocate 
some blocks 



mfdsetU- 



) 



Read in the MFD block 
which contains proper 
entry 






GETNXT 
Obtain a block 
for the UFD 



Set up entries in the Busy Table, the 
MFD block and the Current Sftt 



Write out the MFD block and clear the 
buffer 



1. Set up a new UFD block in the buffer, 
with a back link of -1 

2. Set pointer to indicate location to 
receive the new entry 




Disk "A" Handlers 
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WIPOUT 
Remove file 
entry from 
Vthe UFD 





1. Set "Old file in" switch 

2, Set pointers to UFD block 
number and the first word 
of the olH file's entry 
(to be used at .CLOSE) 




f CKDIRP \ 

Check directory 
vprotection / 



Protection 



Violation 



IOPS63 



OK 



f ENTSET \ 
Preallocate 
vsome block^ 



Read in first UfD block 




SEARCH 
Look for 
a free 
entry 



\L 



1, Read in UFD block with 
free entry 

2. Load "UFDl" pointer in 
Current Set with this 
block number 




GETNXT 
Obtain a 
\block # 



1. Change forward link of last UFD block 
(still in core) 

2. Write out last UFD block 

3. Clear user's buffer 




:omuf: 



Disk "A" Handlers 
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1. Save pointer to new UFD entry in "UFD2'' of the Current Set 

2. Set up pointers to UFD entry slots 

3. Store file neune and extension in the UFD entry 



' GETNJtT \ 
Obtain a 
RIB blocky 



1, Store RIB pointer in UFD entry 

2, Store protection code & date 

3, Insert data block number 

4, Write out UFD block with entry 

5, Clear buffer 



BLDRIB 
Set up 
the RIB 



Set "WREXSW" (Write-executed switch) 



' GETNXT^ 
Obtain a 
iata blocJ 



Clear the buffer to zero 



Return 
to user 
After CAL 



) 



ENTSET 



r. Read in the first Submap 

2. Make it the "Current Map" 

3. Zero indicator of the number 
of preallocated blocks 



LSTFIL 
Preallocate 
some blocks 




(Number of blocks pre-allo- 
cated is the minimum of 
number available and the 
size of the "Temp List") 



Return any preallocated blocks 



RETURN 



I0PS15 
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IOPS63 



1. Clear a buffer 

2. Set words 0, 1, 2, 376, and 377 to -1 

3. Set bits 0-2 of word 3 to MFD size 

4. Set bits 3-17 of word 3 to point to 
first submap 

5. Write out buffer to block 1777, if RF 
or 47040 if RP 

6. Clear the buffer 



(How the handlers ^rite out J:he bit maps 
^ 1 ^ 



RP 



±. 




Which^ 
disk 



RF 



1. Set up forward and backward links in buffer 

2. Set up words 0, 1 and 2 

3. Turn on bit in this submap corresponding 
to itself 

4. Write out the block 




±. 



1. Set backward and forward links to -1 

2. Turn on bits that correspond to MFD 
block and first submap block 



Set bit in appropriate bit map for MFD 




1. Set bit in the first bit map that 
corresponds to second bit map 

2. Set forward link to next block 

3. Write out the buffer and clear it 

4. Set back link to first submap, and 
forward link to -1 



> 



MZ. 



Write out the buffet 



\1^ 



Return to \ 
user ] 

Disk "A" Handlers 
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From Preceding Page 




Reset RIB block pointer in 
UFD to last data block 



Set "word in RIB" in UFD 




WRTUFD 



Write out current UFD block 




1. Write out UFD block currently in core 

2. Reset UFDl to UFD block with old file 

3. Read in the UFD block with the old file's 
entry 



SAMUFD 



1. Reset UFD entry pointer (UFD 2) 

2. Wipe out the old file's entry 



(Give back any unused blocks) 



JL 



UNUSED 



Read in first RIB block used 
Save the forward data link 



Next Page 



Disk "A" Handlers 
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Set for internal looping 
(implicit WAIT) until done 



fciNP-n 




N 



1. Write out current block 

2. Obtain another and 

3. Clear the buffer 
(Subroutine SETWRD) 



<r 



1. Write 2-word EOF line in buffer 

2. Set forward data link to -1 

3. Increment file size 




I TRAN RIB words into last data block 



RNOFIT 



Write out last data block 



1. Read in UFD block for this file 

2. Fill in file size and turn off 
Truncated file bit 

3. Save pointer to first RIB block 



Next Page 



Disk "A" Handlers 
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From Preceding Page 




Reset RIB Block pointer in UFD to last Data Block 



INFPRO 



Set 'Word-in- RIB* in UFD 



(UFD entry is now complete. UFD is 
still in core.) 




WRTUFD 



[Write out current UFD block | 



1. Write out UFD currently in core 

2. Reset UFDl to UFD block with the 
old file's reference 

3. Read it in 



M. 



SMm^ 



1.- Set UFD2 to old file's entry slot 
2. Wipe out the old entry 



(Give back unused blocks. ) 



1. Get first RIB block used 

2. Read it in 

3. Save the forward data link for loop 




Next'^Page 
Disk "A" Handlers 



[nounuJ 
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From Preceding Page 




Find area in this block where 
blocks should be given back 

2. Adjust word of this block 
to reflect only those used 

3. Write out the block 

4. Fudge subroutine LSTFIL so it 
appears UNBUSY called 



f LSTFIL 

(Actual transfer 
^,is to LSTMOV) 





Turn off RIB block's bit in SAT 
and write out the Submap block 



w 

[Set Return to L0C+2|- 



^ UNBUSY 



1. Perform .GVBUF 

2. Zero current set 

3. Make "current" 
.DAT slot zero 



Return to 
LOC+2 



Disk "A" Handlers 
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I0PS6 



MAXSET 



Save pointer to "next" record 




Read in previous block 



CBLOK 



Position record pointer to 
top of the buffer 




Use this record's word pair 
count to point to the next 
record 



Disk "A" Handlers 
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^ 



Return 

to 

user 



Check Header word pair 
Set up the word pair 
counters for moving datay 



yniiinp ModP 



non-Dump 
Mode 



LINFIT 



1. Make Word Pair Count 
negative 

2. Zero checksum word in 
record to be read 

3. Clear line error flag 




' PWORDS \ 
Pass record 
,to user > 




1. Set pointers for a skip over 
the next record 

2. Set "Short Line " Flag 

3. Set return in PWORDS to go 
to ENDINl 



PWORDS 
Skip rest 
of line , 




Disk "A" Handlers 
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INDINII 



Set up "words left 
in data buffer" for 
PWORDS 



Set appropriate 
error bits, if 
any 



PWORDS 

Read to end of 

record or to end 

of data block 




Read in next data block and 
set up pointers, anticipat:-^ 
in the next read 





Pass EOF line: 
001005,776773 




DISK "A" Handlers 
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§ 



READ-WRITE Common Setup Routine 



1. Save pointer to argument data block 

2. Set up return address 

3. Set pointer to checkstrai word in data buffer 

4. Save checksum word 




lOPSll 



1. Set up pointers to "receiver" data buffer 

2. Index SETUP return pointer past argxaments 
to Dvonp Mode exit 

3. Save Word Count from CAL 




Indftx return pointer to Non-Dump Mode 



Return 



' GETWPC \ 

Extract Word Count from line y^^ v . p . n . 

^buffer header word pair 



or w.p.c. 
> 177i 



IOPS23 



RETURN 



Disk "A" Handlers 
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1. Set up return address 

2. Clear "Current Slot" 
number 

3. Get Word Count 




1. Set up for input or output 

2. Get argument block number 

3. Read it or write it 




Disk "A" Handlers 
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lOPSll 



SETUP 
Set up word counter 
and data buffer 




Move in all 
that will 
fit and ad- 
just argument 
size count 



{ SETWRp) 



NOFITl 



( 



SETWRD 



PWORDS 
Pass the record 
to the handler ' s 

buffer 



) 



Jk. 



Set "receiver pointers 
to the top of the 
buffer 



JL 



Compute and insert Checksum 



Move record into buffer! 




fAWORD3 



Disk "A" Handlers 
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(Loop on CAL) 
I 




RETURN 
to LOC+N 



Go to 

Argument 

address 



DISK "A" HANDLERS 



B-24 




/getnxt \ 



1. store nvunber as forward data link 

2. Save current block number 




1, Write out buffer and then clear it 
2. Increment FILSIZ 




^ 



Make this number cnrrent 



BLDRIB' 
Set up 
the RIB, 




I0PS15 



IOPS15 



Return 






Set next block 
number in TLIST to -1 



SETBAK 



I Set backward data link returned from SETWRD [ 



RETURN 



Disk "A" Handlers 
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1. Initialize the map count nxim- 
ber, block count, TLIST 
pointers and TLIST count 

2, Read in the current submap 




1. 
2. 



Start filling the Temp List 
When find a free block, skip 
the next block+DELTA (assem- 
bly parameter) and continue 




Temp List 



Start at bit word 3 




Read in next Submap 



Jl 



EXIT 



Disk "A" Handlers 
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COMMON ROUTINE FOR READING AND 
WRITING TO AND FROM THE DISK 



1. 
2. 
3. 



4. 



Save the calling address 
Get the arguments 
Compute disk hardware 
address from argument 
block number 
Set I/O Undeyway flag 



Start disk I/O 



±. 



Exit to 

loc, in 

EXITAD 



INTERRUPT PROCESSOR 



START 



1. Save PC at EXITAD 

2. Save AC 

3. Turn off I/O underway 
flag 





1. Clear disk flag 

2. Process error 

3. If necessary, 
retry 10 times 



Clear disk flag 



-^ 



Set for Write 
check 



Reset buffer counts 




EXIT 




Attempt recovery on 
CTRL R 



Disk "A" Handlers 

6-27 



APPENDIX C 
ASG 

1 ASSIGN DEVICE UIC TO .[UT 

ASM 

? MACRO ANT LINE EDITOR 

R.PRE V . . / X, 

i?A!?0 ( ) ?i 

»A03((?Ae?(FU TMP)L«)«» 

A ^D00(?r)ll( )«)» <«U^5?(9ni2( )«)?> -11/<»D01(«»C11 ()«» )» <ii»U01 f ^012 { ) e») 5»> -1'^ 

A 9O02(9DU( )S>)» <^U02(»D12( )?)?> -14/«O03(<i«Dll( )9)«» <^U^3 ( i?Dl2 ( ) i5>) »> -13 

A <^D04(Lp).Hi <ff>U04( »012( )!a)^> -12 

MACRO 

»O(BL)<P*-«A?0(r ILTMP)?»D14( )» 

BNK 

2 BANK MODE nPTR AT 1 0^-0^ 
BANK 0^ 

BUF 

2 NUMBER OF FUFEE«S 
PUFFS ^AC?0()^ 

CHN 

1 SPECIFY 7 PR 9 rrUCK MAGTAPE 
C 5»At^0 ( )^ 

CMP 

1 SOURCE COMPARE 

A »D55^<S»Gil( J^)" <'*UC52(9Dl2( )^)»> ■^15/s»Di'l < ^Dll O ? ) ? <SSU3l f <*D12 ( ) 9 ) 5^> -14 

SRCCQH 

;aO< )«♦■<?' An ^^in'^/^A/il n(»i?>D14( )9 

DIR 

1 LIST Directory 
PIP 

L LP*-5»A0p' («D11( )'^)5* <6»U0!?'(^Dl2( )i?')»>(aDl4( )» 



C-1 



DLG 



? LOGOUT 
LOGOUT 



UIC 



DMP 



13 DUMP ijTlLTTV -, DIRECT SUB TlLE 
!»A0?){ ALL)^*D.14( )» 



DOS 



1,3, GENPRAL PRC FILL FOR GIVING COMMANQ STRINGS 
»A00(PD14< )*)» 



FIL 

2 CREATE A file: FROM CAROS/EDlTOR 

A ffD0{^(s»Dll( >»)» <»U0^(«»D12( )9)g»> -14 

A *D!^l(9nil( )»)» <i®U01(PDl2( )»)?> '15 

B.PRE 

«AP'0(FILTMP)!? 

SiA^K^^Af ^(FIi TMP)»)9 



FCR 

2 FOPTRAm IV AND LINE EDITOR 

A »D00{fDll( JP*)* <^UE^P'(»D12( )»)?> -14/(aD01(*Dll( )»)» <e»U01 ^ »012 ( ) (? > ®> -15 

B.PRE 

»A00()» 

36A3l(«»A00(FlL TMP)»)e 

A ''Dg^Cfl'niK )P*5S» <®U0^(9D12( )'?)^> -11/^001 (^DIK )»)«» <»U01 < ®ni2 ( ) ? ) ^> -13 

A ^D02(LP)* <e»U02(«O12( )Si)®> -12 

F4 

«0( BL ><?>*•« A00( F ILTMP )iiB?»Dl4 { )» 



JOB 



7 START NEW JOB 

LOG JOB «A2'0()9i BEGIN i?Dl4{)^ 

T 

LOGIN »A?!2(SCR>» 

A NON 2,3»4,7,10,llil2,13il4,15,l6il7,20/?Dll{)9 1 

PIP 

M ^DIK )# <SCR>'?D14()? 

»A03n* 

KEEP S»A04<OFF)9 
TIMEST ?A0l(l)«J03 



C-2 



KEP 



1 RETAIN DEVICE 
KEEP (?A00( )9> 



ASSIGNMENTS 



LCM 



13 SUPPLFMENT TO LIB PRC-UPQaTE ,LIBR 
!®A0ZI(CLOSE!»Dl3( )ffl)» PA01 {«»0l3 C 5 9)^ S»A02()« 



LIB 



A »D00(9Dll( )5>>(» <^U00<9D12( )»)»> -14 

A »D01(<?n00(®Dll( )8')3)5» <9\JdHPU^^'<9dl2{)»)9)9> -15 

A 5»Df^2(prjll( )^>? <»U02(e>Dl2()^)9> -»1P! 

A »D?3(LP)(^ <S>U03(»Di2( )(B5®> -l2 

UPDATE 

»O<tUS)^*-^A0 ?( .LIBF')P5»D14 1)9 



LNK 

13 DIRECT SUR riLE - BUILDS lInKS FOR EXECUTE EIlE-USE WITH OVL PRC 
?A?!0(fl>»Dl4( )!»)?'v'aDl4( )^ 



LOG 

2 LOGIN UlC 
LOGIN ®A??^(SrR)^ 

LST 

2 LIST CONTENTS OE FILE ON LI^'E PRINTER 

PIP 

T LP*»D03{»Dll{ )(?)!?' <9\J2i{90l2{)^)9> »A00(FIlTMP)9 (A)90lA()Pf 



MAP 



113 DIRECT SUB FJLF FOR CNAIh. OPTION ANu RES CDDF ONLY 
CHAIN • ' 

!:8A00(THpyCT)«?.Qi4( ) $> 

«A01 (S?)5»»P14( )(Jt 
3)A02(FlLTMP)«pDl4( )^ 
«D14( )S* 



MIC 

2 LOGIN MiC UlC 
MICLOG S6A00( )9 
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MNT 



1 MOUNT TAPFtf QM DRIVE U 



- WRITE *AC??(tnCK)(a 



MSG 

13 MESSAGE To OPE'^ A TOR-D I RECT SUB FIlE 
LOG »A00{ )9 



MSW 



13 MESSAGE To OPERATOR W/WA I T-D I RECT SU! 
LOGW !*Af?!? ( ) ® 



NDR 



1 CREATE NEW niRECTORV 

PIP 

V »A00(»T11{ )?))» <«U00(«»D12( )»)9>?D14{ )!» 



OVL 



13 DIRECT SUR FILE - USE FOR BuROlNG OVERL* YS ( CmA I N ) 

CHAIN 

'*A!^0(THpyCT)6Sf»Dl4()6» 

S>API1 1 S2 )i!«i»Dltf( )S> 

«»API2( FIL T'^P)'*P314( )9 

PAG 

2 PAGE MqDE OPERATION-ON 
PAGE OM 

PCD 



2 SPECIFY PRnTrCTION CODE 
P »A.''i0(3)!!a 



QDP 

1 DUMP cnRE TNi TERMINAL ERRORS-NO ARGUMENTS 
QDUMP 



XCT 



? EXECUTF 

A ^D:i?(f»nll ( )?)^ <'»Ui''0(»Ol2( )»)!?> -»4 
E (?A00(TmPXCT)* 



C-4 



INDEX 



Accessibility map, 6-9 

Additions to Non-resident Monitor, 3-4 

Automatic Priority Interrupt (API), 7-1 

hardware, 7-4 

implementation, 7-10 

ON/OFF, 4-19 

software, 7-6 



Bad Allocation Table 
Bank/Page mode, 7-1 
Batch mode .DAT slot 
Block checksum, 6-7 
Block control pair. 
Block list, 6-14 
Block word count (BWC) , 
BOSS-15, 8-1 

accounting, 8-2 
.DAT slot assignments, 
line editor (B.PRE) , 



(BAT) , 6-18 



assignments, 
6-6, 6-7 
6-6 



4-20 
J-21 



4-20 



Bootstrap, system. 
Buffer allocation. 



2-1, 2-7, 4-13 
4-20, 5-12, 6-14 



CAL handler, 2-2, 7-1 
Characters, control, 2-14 
Clock operation, 2-12 
Clock routine, 2-8 
COMBLK, 4-13, 5-1 
Commands to Non-resident Monitor, 
Control characters, 2-14 
Current set, 6-14 



3-4 



File storage, 
FIOPS, 6-5 



3-! 



Handlers, I/O device, 7-1 



Image mode, 6-4 
Input/Output (I/O) 

communication table, 5-11 

initialization, 2-8 
I/O device handlers, 7-1 

writing special, 7-9 
lOPS mode, 6-4 

error handler, 2-2 



Linking Loader, 4-13 

Link status, 7-1 

Loader buffer allocation, A-20 

Loader, system, 4-1, 4-13 



Magnetic tape, 6-4 

file directory, 6-7 

handlers, 6-5 

storage retrieval, 6-11 
Mass Storage Busy Table, 5-13 
Master File Directory (MFD) , 6-12 
.MED error processor, 2-2 
Memory protect, 7-1 
Monitor, resident, 4-13 



Data modes 

Dump, 6-4 

Image, 6-4 

lOPS, 6-4 
DDT loading, 4-13 
DECtape file organization, 6-1 
Device assignment table (.DAT), 
Device table, 5-11 
Disk file structure, 6-11 
Disk handler, 2-6 
Disk resident tables, 5-1, 5-9 
Directoried data recording, 6-5 
Directoried DECtape, 6-1 
Dump mode, 6-4 



Error handler, lOPS, 2-2 
Error processor, 2-2, 2-6 
EXECUTE, 4-13 



Non-directoried DECtape, 6-1 
Nonresident Monitor, 2-12, 3-1 

additions, 3-4 

commands, 3-4 



5-12 Operation of DOS, 1-1 

Overlay Table, 5-9, 5-14 



Patch area. Resident Monitor, 2-14 

PATCH, commands to, 3-8 

PIC interrupt service routine 

implementation, 7-10 
PIP, 6-18 

Pre-allocation of blocks, 6-16 
Priority, software level, 7-1 
Procedure files, BOSS, 8-16 
Program control characters, 2-14 



File accessibility map, 6-7 

File Bit Map, DECtape, 6-2 

File buffer transfer vector table, 5-12 

File identification and location, 6-7 

File information, see Current set 

File locating, 6-7 



Ofile, 3-8 
Queueing, 7-7 



ROOM table, 5-13 

Reserved word locations, 5-13 



X-1 



Resident Monitor, 2-1, 4-13 

PATCH area, 2-14 

timing features, 2-8 
Retrieval Information Block (RIB) , 

6-14 
Run time file (RTF), 8-1, 8-16 



.SCOM registers, 5-1 to 5-6 

used by Loaders, 4-17 to 4-19 
SGNBLK, 4-13, 5-1, 5-8, 5-10 
Skip chain, 5-12 
Software level priority, 7-1 
Special I/O device handlers, 7-9 
Startup routines, 2-8 
Storage, 4-26, 6-11, 6-16 
Storage allocation tables (SAT's) 6-17 
Submaps, 6-17 
SYSBLK, 4-13, 5-1 
System 

bootstrap, 2-7 

initialization, 2-8 

Loader, 4-1, 4-13 



Tables used by Loaders, 4-16 
Temp List (TLIST) , see Block list 
.TIMER routine, 2-12 
Timing features, 2-8 
TRAN routine, 2-7 



User File Directory Table (.UFDT) 

5-12 
User file labels, 6-9, 6-10 
User identification code (UIC) ,6-12 
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HOW TO OBTAIN SOFTWARE INFORMATION 

Announcements for new and revised software, as well as programming notes, 
software problems, and documentation corrections are published by Software 
Information Service in the following newsletters. 

Digital Software News for the PDP-8 & PDP-12 

Digital Software News for the PDP-11 

Digital Software News for the PDP-9/15 Family 

These newsletters contain information applicable to software available from 
Digital's Program Library, Articles in Digital Software News update the 
cumulative Software Performance Summary which Is contained in each basic 
kit of system software for new computers. To assure that the monthly Digital 
Software News is sent to the appropriate software contact at your installation, 
please check with the Software Specialist or Sales Engineer at your nearest 
Digital office. 

Questions or problems concerning Digital's Software should be reported to 
the Software Specialist. In cases where no Software Specialist is available, 
please send a Software Performance Report form with details of the problem to: 

Software Information Service 
Digital Equipment Corporation 
146 Main Street, Bidg. 3-5 
Maynard, Massachusetts 01754 

These forms which are provided in the software kit should be fully filled out 
and accompanied by teletype output as well as listings or tapes of the user 
program to facilitate a complete Investigation. An answer will be sent to the 
individual and appropriate topics of general, interest will be printed in the 
newsletter. 

Orders for new and revised software and manuals, additional Software Per- 
formance Report forms, and software price lists should be directed to the 
nearest Digital Field office or representative. U.S.A. customers may order 
directly from the Prc^rnm Library in Maynard. When ordering, include the 
code number and a brief description of the software requested. 

Digital Equipment Computer Users Society (DECUS) maintains a user library 
and publishes a catalog of programs as well as the DECUSCOPE magazine 
for its members and non-members who request it. For further Information 
please write to: 

DECUS 

Digital Equipment Corporation 
146 Main Street, Bidg. 3-5 
Maynard, Massachusetts 01754 



DEC-15-0DFFA-A-D 
READER'S COMMENTS 



Digital Equipment Corporation maintains a continuous effort to Improve the quality and usefulness 
of its publication:;. To do this effectively we need user feedback ~ your critical evaluation of 
this manual . 

Please comment on this manual's completeness, accuracy, organization, usability and read- 
ability. 



Did you find errors In this manual? If so, specify by page. 



How can this manual be Improved? 



Other comments? 



Please state your position. Date: 

Name: ^^^^ Organization: 

Street: _^______ Department: 



City: ^ State: Zip or Country 



Fold Here - - 



Do Not Tear - Fold Here and Staple 
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